Prerequisites

Before you begin, be sure that you've completed the steps in Connect Amazon Web Services or Connect Microsoft Azure.

We will be using a simple 'Hello World' container. You can find popular container images on Docker Hub.

Create Application Collection

From the Applications dashboard, click 'Add an application'. You will be prompted to name your Application Collection.

Click 'Save' when finished.

Step 1 - Setup Application

Click 'Create Container'. 

Create at least one container and, at minimum, assign the following properties:

Name - give the container a unique nameImage Repository URL - location of docker image (i.e. caylent/helloworldcaylent)Ports - map external and internal ports (i.e. 8080:80 will run port 8080 externally and port 80 internally)

Click 'Save' when finished.

Navigate to Step 2 of the Wizard by clicking 'Next'.

Step 2 - Stacks & Environments

A modal will pop up asking if you want to 'Use Custom' or 'Use Defaults'.

Choosing 'Use Custom' will let you create Stacks individually or attach pre-existing Stacks.

Choosing 'Use Defaults' will create 3 stacks: QA, Staging, and Production. We recommend this for production applications, though it is not a requirement.

You can always delete or add Stacks at any time, so don't worry about making a mistake.

Use Defaults (recommended)

Caylent will automatically create three stacks, with the App Collection name appended: QA-{appName}, Staging-{appName}, Production-{appName}.

You can delete, detach, or edit any of the Stacks that were just created.

Use Custom

If you choose 'Use Custom' then Caylent will not automatically create any Stacks for you. You can create Stacks individually.

You can also attach pre-existing Stacks, if you have created any previously.

Navigate to Step 3 of the Wizard by clicking 'Next'.

Step 3 - Stack Services (optional)

Docker Swarm is a default service deployed on every Stack. You can also deploy optional services, like databases.

Click on any of the default Docker Swarm Clusters.

Click 'Edit' to change the properties of the Swarm Cluster.

Click 'Save' when finished.

Step 4 - Continuous Delivery (optional)

You may specify any continuous delivery tags or regex patterns that you want and associate them with your Stack(s).

If you chose to use defaults for Stacks & Environments in Step 2, a modal will now pop up and prompt you to 'Use Custom' or 'Use Defaults'.

Using defaults will automatically map some common continuous delivery tags based on Stack name.

You can also create custom ones.

Examples:

Version tag / Regex Pattern Stack Enabled Use Case * Development  Automatically deploys every branch, build, or feature staging Staging  Automatically deploys every staging build, mirrors production plus one feature latest Production No Deploys latest/master build in production with one click 

 

Next, continue to the end of the Wizard and click 'Deploy Now' if you want to launch the Stack(s) right away.

Otherwise, click 'Save and Deploy Later'.

Step 5 - Deploy Application

You will now be taken to the console of the Application Collection we just created. From here, you can deploy your app using the 'Quick App Deployments' tool.

Using the dropdown tool you may deploy individual containers - including specific versions of those containers - or the entire collection.

Next Steps

Now that we've covered how to create and deploy an app, you can explore how to configure continuous delivery.

Other things you can do:

Did this answer your question?