How you can do continuous delivery with Vue, Docker, and Azure
A few weeks ago at ng-conf, I announced the launch of vscodecandothat.com — a project I worked on with Sarah Drasner to centralize all of my favorite VS Code tips into a collection of short, silent video clips. It’s like a site full of GIFs, except without the 600 megabyte payload and crashed browser tab.
Sarah designed and built the site using Vue. I put together the video clips with excessive pug references.
Sarah and I both work on the Azure team, so it was a good chance for us to use our own tools here at Microsoft to work with a real application. In this article, I’m going to break down how we do continuous delivery with vscodecandothat.com, and how you can do it yourself using the same tools we use.
Before we talk about the setup, I want to define exactly what I mean by “continuous delivery.”
The term Continuous Delivery refers to making releases easy, fast, and streamlined. We can argue about the exact definition of the term, but just remember that I am a front-end developer so my eyes may glaze over. I may snore. But go on. I swear I’m listening.
For our purposes, “Continuous Delivery” means that the process of building and deploying the site is completely automated. Here’s how that looks in real life:
Got all that? Basically, we’re going to automate everything that you would normally do as a developer so that checking code into Github is all you have to worry about. And lord knows that’s hard enough as it is.
OK, let’s begin at the beginning. The first thing we need to do is look at the application to see how it runs. And how it runs is “In a Docker, y’all.”
index.html page from the dist folder. We use an nginx web server.
When you are just serving up static assets, the Dockerfile is very simple…
# Copy in the static build assetsCOPY dist/ /app/
# Copy in the nginx config fileCOPY misc/nginx.conf /etc/nginx/nginx.conf
# All files are in, start the web serverCMD ["nginx"]
Sarah created an nginx configuration file that we just copy in when the container gets built. Because you do not want to be in the business of configuring nginx (OMG you don’t), Sarah has posted her config file to a gist.
I use the [Docker extension for VS Cod](https://marketplace.visualstudio.com/items?itemName=PeterJausovec.vscode-docker&WT.mc_id= vscodecandothat-medium-buhollan)e so that I can see and manage all of my images and containers. I’m not afraid of the terminal, but my brain can only remember so many flags.
Now we need a registry to push the container to. We’re going to configure Azure Container Services (ACR) for that.
You can create an ACR repository from the web portal, but to prove I’m not afraid of the terminal, we’ll do it with the Azure CLI.
First, we need a group for resources. I called mine “vsCodeCanDoThat”.
az group create — name vsCodeCanDoThat — location eastus
Now create the ACR repository. I called mine “hollandcr”.
az acr create --resource-group vsCodeCanDoThat --name hollandcr --sku Basic
Now we can push our image to that by tagging it with the path to the Azure Container Registry.
In the video you can watch me login to the Azure Container Registry from the terminal. This is important because your push will fail if you are not logged in.
OK — now we need a site to host our container. For that we use Azure App Service.
First create a Linux service plan. For that, you need your app name and your resource group.
az appservice plan create -n appName -g resourceGroupName --is-linux -l "South Central US" --sku S1 --number-of-workers 1
az appservice plan create -n vsCodeCanDoThatSP -g vsCodeCanDoThat --is-linux -l "South Central US" --sku S1 --number-of-workers 1
Now create the web app and point it at the container that was pushed to the AKS registry. This takes 4 parameters.
az webapp create -n vsCodeCanDoThatSP -g vsCodeCanDoThatRG -p vscodecandothat -i hollandcr.azurecr.io/vscodecandothat:latest
And that’s it. You’ll get back a URL, and you should be able to open it and see your site running.
Now what we want to do is automate everything that we just did. We never ever want to have to go through any of these steps again.
The first thing we will do is to set up our site for “Continuous Deployment” from our container registry.
If you are using the App Service extension for VS Code, all of your Azure sites will show up right in the editor. You can just right-click and say “Open in Portal.”
Select the “Docker Container” menu option…
On this page you will see the container you configured from the terminal. There is an option at the bottom to turn on “Continuous Deployment.”
When you toggle this on and click “save,” a webhook will get created in your Azure Container Registry for this specific container. Now, anytime the image with tag “latest” is updated, the webhook will fire and notify App Service which automatically pulls in your image.
So we’ve automated some of this already. Once we push the image, it will be deployed. There is nothing we have to do besides push it. But we don’t want to push it. We want someone else to that.
And who will do it? The robots, that’s who. Or whom? OR WHOMST. Fortunately I’m not in high school English anymore. I failed it once and that was enough.
This is the point at which I tell you that we are going to use Visual Studio Team Services (VSTS). Then you say, “Visual Studio? I’m not using .NET”. And I say, “I know, it’s confusing.”
We need a system specifically designed to automate builds and deployment. This is exactly what VSTS is/does. Also, it’s free for 5 users or less (in a project space) and “free” is the only word in my love language. The only word besides “beer.”
Create a VSTS account if you don’t have one. Once you do, you land on the dashboard screen.
From here, you want to create a new team project.
Give your project a name and a description that nobody will find helpful. Leave the version control at Git.
The next screen gives you a Git URL to check your code into. But we already have Github, so just ignore that and select the “or build code from an external repository” option.
Authorize VSTS to Github and select the repo…
The next screen is offering to help you start with a template. In this case we are going to roll from an empty process. Because we are hard core like that.
Now we are going to start adding steps for VSTS to perform to do the build and deployment. The pull from source control is already happening, so the first thing we need to do is to run
npm install on our code. To do that, add a task to “phase 1”. There is only 1 phase in our build / deployment.
Search for “npm” and add the npm task.
By default, you get the
npm install task, which is exactly what we want. You don’t need to add any options to this task.
Next, we’ll be running the
npm run build command, which will build a production instance of our Vue app with all of its Webpacking magic. For that, add another npm task. This time, change the name to “npm run build.” Set the “command” to “custom” and the “command and arguments” to “run build.”
Great! We’ve got the build, now we’re ready to Dockerize it. Add a new task and find the “Docker” one.
This is a big screen, so here’s the image and then we’ll walkthrough the highlights.
Lastly, we want to push the image. Add another Docker task. This time, set the “Action” to “Push an image”. Set the “Image Name” to $(Build.Repository.Name) — just like before.
DO NOT SELECT THE “PUSH IMAGES” ACTION. If you do, your build will fail and you will blame god and all humanity before you figure out that you selected the wrong action. Don’t ask me how I know that.
And that’s it for defining the Build definition. You can now click “save and queue” at the top. Make sure that you select a “Hosted Linux Preview” agent. The Docker tasks needs the Linux agent.
Now sit back and wait for a build to kick off. If you’ve done everything right, you have now setup a completely automated build and deployment system for a Vue app that utilizes Docker and Azure. That’s the most buzzwords I’ve ever squeezed into one sentence.
This seems like a lot to setup, but once you have it just like you want it, all you have to do is check in code to your Github repo and all of this manual deployment 💩 happens automatically. Your customers will love you. Your developers will love you. Heck — even YOU might love you.
I hope you find this helpful. I’m off to update my résumé with all of these buzzwords.
✅ 30s ad
In this article, I will collect 10 Vue icon component to bring more interactivity, better UI design to your Vue application.
Icons are the vital element of the user interface of the product enabling successful and effective interaction with it. In this article, I will collect 10 Vue icon component to bring more interactivity, better UI design to your Vue application.1. Animated SweetAlert Icons for Vue
A clean and simple Vue wrapper for SweetAlert's fantastic status icons. This wrapper is intended for users who are interested in just the icons. For the standard SweetAlert modal with all of its bells and whistles, you should probably use Vue-SweetAlert 2vue-svg-transition
Create 2-state, SVG-powered animated icons.Vue-Awesome
Awesome SVG icon component for Vue.js, with built-in Font Awesome icons.vue-transitioning-result-icon
Transitioning Result Icon for Vue.js
A scalable result icon (SVG) that transitions the state change, that is the SVG shape change is transitioned as well as the color. Demonstration can be found here.
A transitioning (color and SVG) result icon (error or success) for Vue.vue-zondicons
Easily add Zondicon icons to your vue web project.vicon
Vicon is an simple iconfont componenet for vue.
iconfont is a Vector Icon Management & Communication Platform made by Alimama MUX.
A tool to create svg icon components. (vue 2.x)vue-material-design-icons
This library is a collection of Vue single-file components to render Material Design Icons, sourced from the MaterialDesign project. It also includes some CSS that helps make the scaling of the icons a little easier.vue-ionicons
Vue Icon Set Components from Ionic Team
Design Icons, sourced from the Ionicons project.vue-ico
Dead easy, Google Material Icons for Vue.
This package's aim is to get icons into your Vue.js project as quick as possible, at the cost of all the bells and whistles.
I hope you like them!
Markdown is a way to style text on the web. The 10 Vue markdown components below will give you a clear view.
Markdown is a way to style text on the web. You control the display of the document; formatting words as bold or italic, adding images, and creating lists are just a few of the things we can do with Markdown.
The 10 Vue markdown components below will give you a clear view.1. Vue Showdown
Use showdown as a Vue component.showdown-markdown-editor
A markdown editor using codemirror and previewer using showdown for Vue.js.markdown-it-vue
The vue lib for markdown-it.perfect-markdown
perfect-markdown is a markdown editor based on Vue & markdown-it. The core is inspired by the implementation of mavonEditor, so perfect-markdown has almost all of the functions of mavonEditor. What's more, perfect-markdown also extends some features based on mavonEditor.v-markdown-editor
Vue.js Markdown Editor component.markdown-to-vue-loader
Markdown to Vue component loader for Webpack.fo-markdown-note Component for Vue.js
fo-markdown-note is a Vue.js component that provides a simple Markdown editor that can be included in your Vue.js project.
Markdown Editor component for Vue.js. Support both vue1.0 & vue2.0mavonEditor
A nice vue.js markdown editor. Support WYSIWYG editing mode, reading mode and so on.vue-markdown
A Powerful and Highspeed Markdown Parser for Vue.
Thank for read!
Vue input component gives you a baseline to create your own custom inputs. It consists of a prepend/append slot, messages, and a default slot. In this article I will share 15 Vue input components to you.
Vue input component gives you a baseline to create your own custom inputs. It consists of a prepend/append slot, messages, and a default slot. In this article I will share 15 Vue input components to you.1. Maska
A vue component that wraps a input type=number with a customizable range slider flyout with 2-way binding.
International Telephone Input with Vue.
Allow restricted character sets in input elements.
The Vue Currency Input plugin allows an easy input of currency formatted numbers.
Input components for vue.js.
Simple example of issue I am seeing with input labels.
A Vue.js wrapper for Zurb's Tribute library for native @mentions.
Number input with rich functionality for Vue.js.
Super tiny input mask library for vue.js based on PureMask.js (~2kb) exposed as directive. No dependencies.
mask directive for vue.js
An ip address input with port and material design support.
Tiny input/directive mask for currency
Dead simple masked input component for Vue.js 2.X. Based on inputmask-core.
Mobile & Desktop friendly VueJS input component
I hope you like them!