Link Search Menu Expand Document

Before we start, there are a few terms that you need to get familiar with:

  • Docker application, meant to be used for Docker Compose and Docker Swarm applications, and expecting a raw Compose file as the deployment recipe, and
  • Kubernetes application, meant to be used for Kubernetes applications, and expecting a Manifest as the deployment recipe.

Adding Applications via the UI

It all starts in the Apps page.

app-store

If you don’t have any projects, then you’ll need to create one.

  1. expand the “All projects” tab, and click “+add”

    add-project

  2. click on “Project” and choose a Name and Description for it. Then save.

    create-project


Once inside your project, you’ll see the button “+add”.

  1. Navigate to your project and click on “+add”

    project-page

    add-app

Applications

From the previous “add app” modal, select “Application”.

This will take you to the Application editing page.

For most fields, you’ll find help text to help you configure you Application properly.

edit-app

Quick explanation of most relevant Component fields:

  • URLs, Output Parameters and Data Binding: exactly the same as for Components
  • Files: you can create secrets and configuration files to be used by the containers in your application. This is where you defined those. Make sure the file name matches the one referenced from within the Compose file/Manifest
  • Environment Variables: exactly the same as for Components. However, these variables can also be used from within your Compose file/Manifest. Example: if you define a new env var called myVar, you can use it in you Compose file like this:

     environment:
       - ENV_FROM_NUVLA=$myVar
    
  • Kubernetes manifest: the raw Kubernetes manifest representing your application resources
  • Docker compose: the raw YAML Compose file representing your Docker application resources

Docker subtype compatibility: Docker Compose vs Swarm?

Nuvla allows you to launch Docker applications both as native Docker Compose projects or Docker Swarm stacks.

Depending on your Compose file, Nuvla will automatically infer whether any of your containers requires Docker Compose-specific options or not.

This is how it works…does your application:

  • have Swarm-specific options (like deploy)? Then it will be launched as a Swarm stack

    comp-swarm

  • have Docker Compose-specific options (like devices)? Then it will be launched as a Docker Compose Project

    comp-dc

  • have both Docker Compose and Swarm-specific options? Then it will default to a Swarm stack, and the Docker Compose-specific options will ignored upon launch

    comp-both

  • do not have any Docker Compose or Swarm-specific option? Then it will be launched as a Swarm stack

    comp-dc

For more information about which options are Docker Compose and Swarm-specific, please consult the original Compose reference documentation.

Adding Applications with the Python Library

(coming soon…)

Enabling fast & dedicated monitoring for Application Deployments

When you launch an application, Nuvla starts scheduling metric collection jobs for retrieving your deployment’s state, parameters, etc.

These jobs are scheduled at a well defined and short intervals.

However, if you need faster updates on your deployments (aka shorter response time), SixSq offers an additional sidekick container that you can adjoin to your application, which will push those deployment metrics to Nuvla much more regularly.

Here’s an example on how to do it:

1. let’s say you have a Docker Stack application…and this is your Compose file:

  version: '3'

  services:
    someservice:
      image: someimage:tag
      deploy:
        replicas: 4

2. to enable this fast and dedicated deployment monitoring, please add the sixsq-deployment-monitor service to your Compose file:

  version: '3'

  services:
    someservice:
      image: someimage:tag
      deploy:
        replicas: 4
        
    sixsq-deployment-monitor:
      image: nuvladev/job:multiarch
      entrypoint: /app/job_deployment_state_push.py
      deploy:
        placement:
          constraints:
            - node.role == manager
      environment:
        - NUVLA_DEPLOYMENT_ID=$NUVLA_DEPLOYMENT_ID
        - NUVLA_ENDPOINT=$NUVLA_ENDPOINT
        - NUVLA_API_KEY=$NUVLA_API_KEY
        - NUVLA_API_SECRET=$NUVLA_API_SECRET

NOTE: if your application is Docker Compose compatible, then simply remove the entire deploy section from the sixsq-deployment-monitor service