Quick Start

This section contains the steps to help you through your first run :smiley:

Quick Start

The dashboard is accessible at https://ship.argonaut.dev.

To create clusters, environments, and services programmatically, follow the steps listed in the Documentation page.

The instructions to get the CLI and integrate with your CI provider are present there

First run

AWS is currently supported, with GCP support coming soon

Provide access to Argonaut by adding in the access method (key and secret for aws).

First runFirst run

Once the access is provided, you will have an option to create a cluster (which is a logical grouping of environments), and the associated environments.

Create an environment

Clusters and environments

The configuration for the clusters is as follows:

New EnvironmentNew Environment

The cluster creation process takes ~15 minutes to get setup on your cloud. Currently, the creation progress can be tracked by going to the "Pending Environments" page. A detailed output will be added shortly.

When an environment is created, the kubernetes cluster is automatically setup with some essential tools. These are:

  • cert-manager to manage TLS certificates and enable https for domains
  • ingress-nginx to manage traffic ingress
  • cluster-autoscaler to automatically scale the number of compute instances based on load and applications
  • prometheus , metrics-collector, kubernetes-metrics-exporter for displaying information about infrastructure and services that are running

The environments page has all the environments that are created. Clicking on infrastructure will give the list of clusters and other resources that have been provisioned in that environment.

List of EnvironmentsList of Environments

Connect to GitHub or Gitlab

Navigate to the Connections page from the sidebar and click on connect Github. Connect the organizations and registries that you want to deploy from.

Deploy your first service

From Github repository

List of AppsList of Apps

Create a new service

  1. The yaml configuration format for the service is detailed on the Documentation page.
  2. The example service descriptor can be directly modified in-place and deployed instantly
  3. The file can be provided along with your source files in version control and be invoked as a part of the CI process using the art cli.
  4. The yaml configuration format for the service is detailed in the Documentation page.
  5. The example service descriptor can be directly modified in-place and deployed instantly
  6. The file can be provided along with your source files in version control and be invoked as a part of the CI process using the art cli.

Install App from GitInstall App from Git

Install App from ImageInstall App from Image

Install App from LibraryInstall App from Library

A quick demo of the usage is available here - https://www.loom.com/share/b26a00f40bd3475db5f7e31f2b2ec7f5

Deploy an observability stack

From the list of third party tools available as direct integrations, pick one. The following stacks are supported:

  1. Grafana, Loki, and Fluentbit
  2. Datadog
  3. AWS Opensearch with elasticsearch and kibana compatibility (v7.10)

This can be setup through the Apps > New App from Library section