A Docksal Training -- ON DEMAND!

jflynn — Sat, 19 Dec 2020 00:49:45 +0000

A Docksal Training -- ON DEMAND! jflynn Fri, 12/18/2020 - 18:49

It has been quite a while since I last posted anything, mainly because 2020 has been 2020 and I haven't been in the best mindset for several months. I've had a lot of difficulty focusing on anything, and as a result, I've found my motivation has gone pretty much away.

However, last month I decided that lack of motivation be damned. I spent quite a bit of time converting a training that I had prepped to give at camps and conferences into a YouTube video series. This is a 12 lesson series that takes the viewer from a brief intro to Docker all the way up to building a custom Docksal application that combines 2 servers with a NodeJS backend and a PHP backend to simulate a production decoupled web application setup.

Here is a quick rundown of the videos and what you might expect from each:

Part 1 - Intro and Docker Basics

The first video is a starting point for someone who may or may not have much experience with Docker. I wouldn't recommend learning React without knowing some JavaScript, so I can't recommend using Docksal without having a bit of an understanding of Docker.

Part 2 - The Gush

This second part is basically where I fanboy about Docksal and why I think it's great. If you want to hear me ranting about the benefits of Docksal and everything it brings to the party, this is your clip!

Part 3 - Docksal Stacks

Docksal uses .yml files that define various stacks. Stacks are collections of services that make up an application. If you want to learn more, stop reading and check out the video!

Part 4 - Docksal Services

Remember way back under the last video when I used the word "services"? I remember. This video goes into what services are available to make up the stacks that are preconfigured or that you build on your own.

Part 5 -Getting Started with Docksal

Yeah, I know... 5 videos in is a long time to wait for a "Getting Started" vid, but the wait is worth it. Get your editors ready, roll up your sleeves, and get learning!

Part 6 - Using a Boilerplate

It's not just for warming the kettle anymore! A boilerplate is a ready-to-go application that you just need to start and it works. In part 6 we're going to look at spinning up a project with one of these boilerplates.

Part 7 - Installing a Drupal Site

This is what we've been working up to. This video will show you how to use Docksal to install and run a brand new Drupal site on your local machine. It takes less time than you think!

Part 8 - Doing More with Docksal and Drupal

Let's take it to 11. This tutorial goes over some of the ways we can further customize a local site, going so far as making the local Docksal environment actually mirror our hosting platform!

Parts 9, 10, 11 - Advanced Customization Projects

Each of these gets a little more in-depth with the customizations and they build off the previous for the most part. I had a lot of fun coming up with Project 3. What do you think?

Part 12 - Local Files

Let's call this one a bit of housekeeping. It doesn't matter what you use Docksal for if you end up committing your API keys to a public repo. (Don't do that!) This one goes over how to use local Docksal files to keep your safe, secret info safe and secret.

Conclusion

This is my first attempt at instructional videos, but hopefully not my last. I'll be posting stuff as I can when I have time, but I'd really like to know what you all would like to see me cover. Feel free to comment on one of the videos above, on this post, on Twitter, or wherever else I might see it. Be sure to subscribe to my channel JDDoesDev on YouTube to get notified when I put new stuff up. Until then, you're my favorite person.

Docksal gets a Training

jflynn — Tue, 12 Nov 2019 23:19:43 +0000

Docksal gets a Training jflynn Tue, 11/12/2019 - 17:19

In July of last year I started a new job as a developer with a new agency. During my first week, in between meetings, HR trainings, and all the other fun things that happen during onboarding, I was introduced to the preferred local development environment that was being used on most of the projects.

It was lightweight, based on Docker, it ran easily, and it was extremely easy to configure. Prior to this, I had bounced around from local setup to local setup. My local dev environment resume included such hits as MAMP, WAMP, Acquia Dev Desktop, Kalabox, VAMPD, DrupalVM, Vagrant, ScotchBox, VirtualBox, native LAMP stacks, and everything in between. All of them had their strengths and weaknesses, but none of them really had that spark that really hooked me.

Enter Docksal.

When I first started using Docksal, I thought it was just like any other setup, and to a point, it is. It creates a reusable environment that can be shared across multiple developers and setup to mimic a hosting provider to a certain point, but the two things that really grabbed me were how easy it was to get started and how fast it was compared to other systems. Docksal has one key, killer feature in my opinionated mind, and that’s the fact that the entire application is written in Bash. The primary binary (which may or may not be the name of my upcoming one-man, off-Broadway, off-any stage show) begins with #! /usr/bin/env bash and runs on any system that has the bash executable, which encompasses Linux (of course), macOS, and now Windows thanks to WSL and the ability to add Ubuntu.

One thing that was missing, though, was a training guide. It has AMAZING documentation, available at https://docs.docksal.io, including a great getting started walkthrough, but for someone just starting out using it who might not have guidance and support from people they work with, it might take a little getting used to.

If you know me, you know that I enjoy talking at conferences. I’ve given over two dozen presentations at several types of events from local meetup groups to national level conferences. If you don’t know me, you just learned something new about me. Since I enjoy talking in front of people so much, the next logical step was to find something I’m familiar with and make a training of it. Turns out, I’m familiar with Docksal.

I submitted my pitch for a training to NEDCamp, the New England Drupal Camp, and they accepted it. Since I now had a reason to write a training, I began writing a training. Initially, I started with a very high-level outline, and eventually built a framework for my training. Thanks to the nature of open source, I was able to use many of the features that https://docs.docksal.io already had in order to make my training seem a little familiar to current users and easily accessible to new users.

The first go at this training will be at NEDCamp 2019 on Friday, November 22nd. This will be the first time a dedicated training spot has been used to train on Docksal, and I'm extremely excited to see how it goes and how to improve. After that training, I will make my handbook available online, eventually to be merged into the Docksal Github repo as part of the documentation. I have had help from numerous people in building this training, especially from the Docksal maintainers, Sean Dietrich, Leonid Makarov, Alexei Chekiulaev; folks who have reviewed what I've written so far, Dwayne McDaniel and Wes Ruvalcaba; and people who have challenged me to learn more about Docksal, whose numbers are too high to list them all.

If you're interested in learning how to use Docksal or what it's all about, consider attending my training at NEDCamp on November 22nd. You can find all the details on the NEDCamp training page, and if you can't make it, be sure to watch for the handbook to be released soon.

Since I'm still working on the finishing touches, why not take the time to let me know what you would like to get out of this type of training or what you wish you would have known when learning how to use Docksal or a similar product in the comments and where you feel extra attention should be placed.