Get Started with Skopos for Docker

Skopos is the first Continuous Deployment System for Containers

Skopos enables Fast, Reliable and Repeatable Production Deployments for Container-based Services on Docker CE, Docker EE and Amazon ECS.

Ready to try it out?
Get Started with Skopos Continuous Deployment System here!

Get Skopos

Step 1: Opt-in   (optional)

Step 2: Install Skopos

Run Skopos container:

Step 3: Open Skopos

Open your browser:

Go to http://<hostname>:8100
to open the Skopos web UI.

Be sure to replace <hostname> with your host or IP address.

Get Acquainted with Skopos

Now that you’re all set up, here are some of the basic Skopos features to check out.

Select Your Level of Deployment Autonomy
Use the Auto-pilot steering wheel button to select the desired deployment autonomy level (usually auto-detect or auto-deploy). Auto-detect will detect changes to your application and generate a plan but it will wait for your action prior to deploy. Auto-deploy will detect, plan and deploy autonomously.

Using this setting enables multiple applications to deploy autonomously based on the change of the same container or model (e.g., multiple geographies or Dev/Test/Prod environments).

Select An Action
Use the Action button to select desired action such as Deploy, Force Replace and Teardown. To execute the selected action, use the Start button.

  • Deploy: Deploys your application, whether from scratch or an upgrade of any modified components.
  • Force Replace: Refreshes all services, even if they have not changed.
  • Teardown: Stops and removes all services of the application. The application will remain integrated with Skopos should you want to Deploy and Start it again.
View the Deployment Plan
Skopos automatically plans out your selected action (deployment, force replace or teardown) by comparing the existing application to the new desired state. Click on “Switch to Plan” button to view the generated plan. Select each step to view the detailed plugin, action and parameters for the step. Notice the rollback plan is automatically generated as well. On error, the rollback plan will execute and a detailed error message presents within the step where the failure occurred.

Deploy Your Application
To deploy your application, select the Deploy option in the Action drop down and then select Start. While the deployment proceeds, you can view the Model to see which components are updated or switch to the Plan to see each step of the deployment process get executed.

Control Your Deployment
Click “Switch to Plan” to view the available deployment actions. You can Pause/Resume, Single-Step or Abandon the deployment at anytime.

  • Pause/Resume: Stops the deployment progress and awaits further instruction. Highly useful when you really need to grab a cup of coffee during a deployment.
  • Single-Step: Allows you to step through the deployment one-step at a time. This is helpful for troubleshooting or testing a deployment plan.
  • Abandon: Stops the current deployment process and does not execute the rollback steps. Use this if you want to manually correct the deployment or fail-forward by fixing the problem and letting Skopos figure out how to deploy the change.

If the deployment hits an error, Skopos automatically rolls back the failed service keeping any successful parts of the deployment as is. Skopos will also extract and share the details of the error within the plan itself, providing you context on what failed and where it the error occurred. Also on failure, Skopos can automatically pause before rolling back. This is helpful so that you can both review and diagnose the problem determining your next steps — rollback or abandon.

Edit & View the Model, Environment and Plan Descriptors
The Model, Environment and Plan are all described in a simple YAML format. This is useful for editing the files as well as change control. Since these files are not in a database but are stored at .yaml files, you can easily check the model, environment and plan in to your code repository for a specific release. To view or edit these descriptors while in the Skopos user interface, click the { } button on the upper right of the screen. You may choose to edit the model descriptor to scale your service (add replicas) or troubleshoot a specific component. The changes made to the descriptors via this user interface will only last during your current session.

Let’s Take it to the Next Level

Enough of basics. Here’s how to begin improving your deployment process.

Implement Continuous Deployment

Skopos offers several methods for autonomous deployment of new application artifacts (code, data) to live systems including Skopos™ Auto-PilotCI/CD pipeline integration and a combination of the two.

Enable ChatOps Notifications

Skopos can send notifications to Slack whenever deploys start and end, or any other significant events occur. You can use both the pre-defined deploy notifications that come built into Skopos or create your own user-defined notifications at specific points or as a result of specific events in the deploy process.


Add Quality Gates

Probe your deployment at key steps to ensure success by injecting quality checks along the way. Lifecycle events can be inserted into your plan by defining them in your model file. This allows you to insert your own scripts to be executed at certain places in the plan.

We Love Feedback

If you try Skopos – or decide not to try it – please send us your feedback on what you liked and what we can improve upon.

  • This field is for validation purposes and should be left unchanged.

Want to Learn More?

Check out our documentation, FAQs or contact us through our Gitter for extra help.