Reading Time: 4 minutes
Codeship offers developers a vast array of possibilities when creating a continuous Integration and deployment pipeline for their applications. I want to focus today on how to build a solid CI/CD pipeline for a Django application with Codeship.
Setting Up Your Local Environment
Our tutorial is going to require a few prerequisites:
- Docker Community Editiion
- A local download of our sample Django To-Do app
- A Codeship Basic account – Sign Up
- A Heroku account – Sign Up
We’ll kick things off by configuring our local application. Once downloaded, we can test out the Docker build process by running:
This will tell Docker to pull in all our dependencies and build our container ecosystem. Once the build is finished, we’ll be able to run commands from within the container. More specifically, a successful build allows us to run our test suite by using the following command:
docker-compose run web ./manage.py test
Our containers will then boot up, run all of the tests, and exit. All of the tests should pass with flying colors. With a passing test suite in hand, we’ll now be able to move on to translating our setup to Codeship.
Setting Up Your Codeship Basic Project
With a local instance of our Dockerized application set up, we then start building our Codeship build and deployment process.
First, we’ll log into Codeship, navigate to the Projects tab, and create a new project. We’ll then select our method of source control (GitHub, Bitbucket, GitLab) and point Codeship toward our application.
After our application connects, we’ll be presented with the option of making our project a Codeship Pro or Codeship Basic project. For this example, we’ll be running with Codeship Basic.
Next up is the formulation of setup commands. Our setup for Django applications would look exactly like it would if we were configuring our application locally without Docker.
psql -p 5432 -c 'create database todos;' # Create our database pip install -r requirements.txt # Install requirements python manage.py migrate --noinput # Run database migrations
With our setup commands formulated, we’ll move onto creating the test pipeline. With Codeship Basic, we only have one pipeline at our disposal. Each of these setups will run in sequence, instead of parallel. For our application, this won’t come too much into play since we only have one pipeline command needed.
python manage.py test --noinput
This command is very similar to the one that we ran within our Docker container in the local setup step.
Finally, we’ll navigate over to the Environment tab and set a variable for our application:
We set the database URL in our environment so that our Django application can figure out where our Postgres database is.
With our Codeship CI pipeline in place, we can now save our setup steps and move on to testing it out! You can trigger a new build by committing new changes to your local project.
git add --all git commit -m "my first codeship build" git push origin master
This process should trigger our Codeship build pipeline and yield a successful build on Codeship.
Mixing in Heroku Deployment
With our passing Codeship build, we’ll now set up our Heroku deployment step in our pipeline. In our Codeship Project page, we’ll select Project Settings and click on the Deploy tab.
To start things off, we’ll need to add our Codeship project’s SSH key to the application. We can find our project’s SSH key under the General tab in Project Settings. Create a
.pub file locally and add it to Heroku via the command line:
heroku keys:add your_new_key_file.pub
This will allow Codeship to communicate and push to Heroku if our test suite passes.
Next, we’ll configure the deployment pipeline on Codeship’s side. To start this, we need to grab our Heroku API key:
- Click on your avatar in the upper right, then click Account Settings.
- Near the bottom of the Settings page, you will find an API key. Click Reveal.
- Copy the API key.
With the API key copied, navigate to the Deploy tab under project settings. Find the Heroku tile and click on it. You’ll then be asked for your application name (as in what it’s named on Heroku) and your API Key. Fill out those fields and click Create Deployment.
To test out our new deployment step, make a quick code change to the
README of the application and commit the results. This should trigger our pipeline that should follow this pattern:
- Download and configure your project on Codeship.
- If configuration is successful, run tests on project.
- If tests pass, deploy the application to Heroku.
Once this process fully completes without any errors, you then will have a successful Codeship CI/CD pipeline!
With a rock-solid testing and deployment pipeline in place, we can now rapidly develop and deploy in record time. While Codeship Basic is incredibly effective for accomplishing this, Codeship Pro offers even more possibilities and potential for our processes.