In this tutorial, I cover concepts such as creating, building, and deploying Vue.js projects. You will learn how to:
- Create a Vue.js project using the Vue CLI
- Create a Toolchain on IBM Cloud
- Deploy static web applications to Cloud Foundry
This tutorial assumes you understand the fundamentals of Vue.js development. To complete the steps in this tutorial, you need to:
- Create a free IBM Cloud account
- Install Node.js on your system
- Install Vue CLI on your system
- Install Git on your system
- Create a GitHub account
- IBM Cloud is a suite of cloud computing services from IBM that offers both platform as a service (PaaS) and infrastructure as a service (IaaS).
- Node.js is an open source, cross-platform runtime environment for developing server-side and networking applications.
- Vue CLI is a globally installed npm package and provides the Vue command in your terminal.
- Git is a free, open source distributed version control system designed to handle projects quickly and efficiently.
- GitHub is a distributed version-control platform where users collaborate on or adopt open source code projects.
- Cloud Foundry is an open source, platform-as-a-service (PaaS) on IBM Cloud that enables you to deploy and scale apps without managing servers.
Step 1. Create a Vue project
Make sure the Vue CLI is installed correctly by running:
$ vue --version
Navigate to the directory where you want to store your project and create a new Vue project via your command prompt.
$ vue create vue-tutorial
After your project is created, you can run the project with the following commands:
$ cd vue-tutorial $ npm run serve
Open your favorite browser and navigate to the URL where the app is running; in this case it’s running at http://localhost:8080.
Step 2. Commit your changes
Now that you’ve generated a boilerplate application (otherwise known as a template or skeleton application), it’s time to make changes to the application to personalize it with your project’s requirements.
Depending on the size of the project, application development can take a long time. You need a version control system tool to keep track of the project, see what changes you’ve made (and why), undo features, and the like. This tutorial uses two version control systems — Git and GitHub. If you need a refresher on these tools, read the Learn the workings of Git, not just the commands tutorial.
Vue CLI initializes a Git repository inside a project and makes the first commit by default.
Let’s make a small modification in the main page and make our second commit. For that, open the project with your preferred code editor and find the file under the /src/App.vue folder. Change the line number 4 as
<HelloWorld msg="Welcome to Your Vue.js App"/>.
Note: If you did not stop the serving process on the terminal, you can see the changes instantly. If you already stopped the process, run
npm run serveagain in the project directory.
Return back to your existing CLI and stop your development environment with
Ctrl + Cor open a new CLI window and change the directory to your project.
$ git add . $ git commit -m "my commit"
Git runs locally on a computer, but GitHub might be a better choice because you can host your repositories in a remote server and protect them from local crashes. We will create a remote repository and push our local commits to GitHub servers.
Now it’s time to create a new repository on GitHub and add the URL for the remote repository where your local repository will be pushed. To do that, go to your GitHub account on your browser and create a new repository, name it, and give it a description.
Finally, you need to push the changes in your local repository up to the remote repository that you specified as the origin. You can either copy and paste the commands GitHub gives you right after you create the repository or use the commands below, inserting your repository URL.
$ git remote add origin <your_remote_repository_url> $ git push -u origin master
Step 3. Deploy your project to IBM Cloud
Using DevOps practices enables you to adjust quickly to changing requirements and still ensure stable application deployments. This tutorial follows DevOps strategies to deploy your Vue project to IBM Cloud.
Toolchains in IBM Cloud are a set of tool integrations that support development, deployment, and operations tasks. There are a large number of toolchain templates depending on your intention. For this tutorial, select the one for Cloud Foundry. Delivery Pipeline is an essential component of any toolchains where the Build, Test, Release, and Deploy steps of continuous integration and continuous deployment are handled.
Log in to IBM Cloud with your credentials and find the Toolchain service under the Developer Tools section in the Catalog. After selecting Toolchain service, you will see numerous toolchain templates.
Select Develope a Cloud Foundry App from the list of templates.
- Name your Toolchain service.
Complete the tool integration steps by doing the following:
- Select GitHub as the source provider.
- Authorize IBM Cloud Toolchains to work with GitHub.
- Set your repository type as Existing.
- Specify your repository URL; this is the GitHub repository you created in previous steps.
- Create and IBM Cloud API Key for Delivery Pipeline, respectively.
Click Create to complete this step.
Note: You should select the region, organization, and space correctly while creating Cloud Foundry applications. If you are not sure what values to use for these fields, go to Manage > Account and select Account resources > Cloud Foundry orgs.
After completing the steps above, your toolchain should be created successfully; however, it will fail when you try to deploy it because your configurations are incorrect. The following steps show you how to fix the configurations in your Delivery Pipeline, which has two separate stages — Build and Deploy.
Thus far, you have used the
npm run servecommand to develop Vue projects on your local system. For production purposes, your code must be built. You can do this by running the
npm run buildcommand.
Instead of building the source code every time in your development environment, you will set the toolchain to build the code in the Build phase.
To configure the Build stage, select the Delivery Pipeline component and click Configure Stage under the Build stage’s gear button. Change the Builder type
npm run buildunder the
npm installcommand. Save this new configuration.
We are going to deploy our Vue.js application to Cloud Foundry which is as PaaS that ensures the fastest, easiest, and most reliable deployment of cloud-native applications. Cloud Foundry application specs are set in the file named manifest.yml. You can find more information about manifest.yml attributes in the Cloud Foundry documentation.
You should create a manifest.yml file inside the main directory of your project where you set basic information about your application. After adding manifest.yml file to your workspace, commit and push the changes so that both your local and remote repositories notice the added file. Since changes in your GitHub repo trigger the pipeline where the Build and Deploy stages start doing their tasks in order, a new process will start automatically. If you are fast enough to switch your screen to your browser, you can see your pipeline already doing its job.
applications: - name: vue-tutorial path: ./dist buildpack: https://github.com/cloudfoundry/staticfile-buildpack.git random-route: true memory: 256M env: FORCE_HTTPS: true
This is what you expect to see when the CI/CD pipeline ends.
Step 4. Navigate to your project
Congratulations! You successfully deployed your front-end application to IBM Cloud! Now let’s see how you can navigate to the URL via a browser.
In the IBM Cloud web console, search your Cloud Foundry application name via the search bar and select your application. You can either click on Visit App URL or navigate to the route listed in the Routes section at the top right corner of the screen.
Your toolchain has created a new Cloud Foundry application and assigned it with a random URL. Finally, you have your application running in the cloud and ready to share with your friends and colleagues!