Continuous Integration & Deployment
Nanobox is a micro-platform that can run anywhere including on continuous integration (CI) and/or continuous deployment (CD) servers. This doc walks through installing and using Nanobox in your CI/CD workflow.
Before getting into the specifics, it's important to have a high-level understanding of the workflow.
- Install Nanobox on your CI/CD server
- Use Nanobox to build your app and run your tests on the CI/CD server
- Define actions based on the exit code of tests
- The CI/CD server cannot be a Docker container. Nanobox builds your app using Docker containers and Docker in Docker doesn't work well. The CI/CD server can't share kernel space.
- A linux distribution and version that supports Docker.
Install Nanobox on Your CI/CD Server
In your CI/CD server build process, install Nanobox. You can use the Nanobox CI/CD Bootstrap script, or you can install Nanobox manually.
Using the Nanobox CI Bootstrap
Nanobox provides a bootstrap script that will download and install Nanobox on your CI/CD server.
- Ubuntu 14.04+
sudopermissions (Required if Docker is not already installed)
The following command can be used in your CI/CD server build process to download and run the CI bootstrap script:
sudo bash -c "$(curl -fsSL https://s3.amazonaws.com/tools.nanobox.io/bootstrap/ci.sh)"
Install Nanobox Manually
To install Nanobox manually, download the Nanobox package appropriate to your Linux distribution and install it on your system $PATH. Depending on where you install it, you may need
After installing Nanobox manually, be sure to enable Nanobox's
ci-mode. This will disable the output summarizer and avoid conflicts with your CI/CD output summarizer. This is done automatically if using the CI bootstrap script.
nanobox config set ci-mode true
ci-mode set to
true, you also have the option to enable
rsync logs. These are disabled by default, but can be helpful when debugging. If you'd like to include
rsync logs in your output:
nanobox config set ci-sync-verbose true
Some functionality in Nanobox requires authentication with your Nanobox account, such as deploying to a live app. To avoid being prompted for account credentials, add the following environment variables to your CI server.
Note: If your CI/CD provider supports it, we recommend encrypting these environment variables to keep sensitive information from being in viewable in plain text in the codebase.
Use Nanobox to Run Tests
With Nanobox installed in your CI/CD server, you can use it to build your app and run your tests. How tests are configured depends on your CI/CD provider, but you simply use the
nanobox run command to run your tests.
nanobox run your-test-script
Nanobox will provision your app on your CI/CD server and run your test script(s). Once your testing script(s) finish, Nanobox will return the exit code to your CI/CD provider.
Based on the success or failure of your tests, certain actions can be triggered such as merging into a branch or deploying. How these actions are configured and triggered depends on your CI/CD provider, but to deploy to a Nanobox app, you just add your app as a remote and deploy.
Be sure to include the account credential environment variables to automate the login process.
# Add your Nanobox app as a remote nanobox remote add app-name # Deploy to your app nanobox deploy
Reach out to firstname.lastname@example.org and we'll try to help.