Quick Start

The average time for Kontena users to get from zero to hero is just under 20 minutes! Let's assume you have already created some amazing application and packaged it as docker containers, here's what it takes to get from zero to hero with Kontena:

  1. Sign-up to Kontena Cloud.
  2. Create an organization for Kontena Platforms.
  3. Create a Kontena Platform.
  4. Install Kontena Nodes.
  5. Deploy first Kontena Stack.

Step 1. Sign-up to Kontena Cloud

You can sign-up to Kontena Cloud by following this link: https://cloud.kontena.io/sign-up

Step 2. Create an Organization

After you have signed up and verified your email, you can create an organization for your project. An organization is a workspace for development teams to monitor, manage and operate Kontena Platforms.

Create Organization

Step 3. Create a Kontena Platform

The Kontena Platform will abstract all available compute resources and make these resources available to your container workloads. To create your first Kontena Platform, just open the 'Create Platform' dialog and fill in the platform name. For testing purposes Mini platform type is enough.

Create Platform

After clicking the 'Create' button your Kontena Platform will be provisioned shortly to Kontena Cloud.

Step 4. Install Kontena Nodes

When the platform is ready you'll need some Kontena Nodes to run your containerized workloads.

After selecting Kontena Cloud as the provider and clicking the 'Add nodes' button, terminal windows should open and you can choose a node type and the number of nodes you want to create.

Provision Nodes

You can always execute cloud node create later in the terminal to provision additional Kontena Nodes to your Kontena Platform.

Note! While Kontena will work with just a single Kontena Node, it is recommended to have at least three Kontena Nodes provisioned in a Grid.

If you followed the steps above, you should now have a working Kontena setup installed. Verify the setup using the node list command. It should list all the Kontena Nodes in your Kontena Platform.

> node list
NAME              VERSION   STATUS       INITIAL   LABELS
⊛ damp-forest-2   1.4.0     online 11s   1 / 1     region=eu-west-1,az=a,provider=kontena

Step 5. Deploy Your First Application Stack

After the provisioned node is online, you are ready to deploy your first application stack. To install a ready-made stack you can execute stack install kontena/hello-world command in terminal.

Install Stack

The initial stack deployment may take some time while the host nodes pull the referenced Docker images.

After the stack deployment is finished you can verify from the Kontena Cloud Dashboard that the lb and web services are running or executing the stack ls command:

> stack ls
NAME            STACK                       SERVICES   STATE     EXPOSED PORTS
⊛ hello-world   kontena/hello-world:1.0.0   2          running   *:80->80/tcp

To test the installed stack, you must connect to the IP address of the host node publishing the lb service on TCP port 80. You can use the public IP address of the host node running the service instance displayed as part of the kontena service show output service show hello-world/lb:

> service show hello-world/lb
   ...
   hello-world/lb/1:
      scheduled_to: damp-forest-2
      deploy_rev: 2017-11-10 08:11:10 UTC
      rev: 2017-11-10 08:11:10 UTC
      state: running
      containers:
        hello-world.lb-1 (on damp-forest-2):
          dns: lb-1.hello-world.quick-start.kontena.local
          ip: 10.81.128.41
          public ip: 18.194.195.204
          status: running

You can also browse services on the Kontena Cloud Dashboard to see stats, logs and configuration of each deployed stack service.

To explore and install ready-made stacks you can use the stack reg search command or see the following examples:

Congratulations -- Enjoy!

This completes the quick start guide for setting up Kontena. For further learning, you can continue by reading the following:

Advanced

Quick Start with Kontena CLI

If you prefer creating a Kontena Platform from your local machine with the Kontena CLI, please follow Quick Start with Kontena CLI guide.

Maintain the Kontena Platform yourself

If you'd like to tinker and maintain the Kontena Platform yourself, please follow the slow start guide.

We hope you will find this documentation helpful! If you have any suggestions on improving our documentation, please open an issue on GitHub.

results matching ""

    No results matching ""