/kotsapps

Primary LanguageMustache

KOTS Applications

Manifests of multiple applications, showcasing how easy it is for various applications to get up and running with KOTS.

Installing KOTS Applications to Existing Kubernetes Clusters

  1. Identify the application slug based on the root directory of the application (e.g., for /nginx-ingress/, APP_SLUG=nginx-ingress)
  2. Ensure that you have KOTS installed (e.g., curl https://kots.io/install | bash)
  3. Execute kots install for the name of the application directory (e.g., kubectl kots install nginx-ingress)

Installing KOTS Applications to Machines without Kubernetes (Embedded cluster installs)

  1. Identify the application slug based on the root directory of the application (e.g., /nginx-ingress/, APP_SLUG=nginx-ingress)
  2. Use curl to perform a kURL Install using the name of the application directory (e.g., curl -sSL https://kurl.sh/$APP_SLUG | sudo bash)

List of Applications:

  • nginx-ingress : Ingress setup to a running instance of NGINX
  • initcontainer-logs : Example showing how to collect logs from init containers with Troubleshoot.sh collectors
  • postgres-snapshots : Example showing best practices for integrating an application that requires a PostgreSQL database.
  • helm-grafana : Example showing how to build a KOTS application using a helm chart. In this case, we use the Grafana helm chart.

CONTRIBUTING

Overview of CI

The CI process is as follows:

  1. When GitHub detects a change within an application's directory, the CI process is started for each application.
  2. The common makefile is copied to the local application directory, to ensure the same process for each application.
  3. make release is executed on the copied makefile, which performs linting and attempts to make a new release.
  4. If the release is successful, the CI process passes.

A common makefile is used in the CI process to ensure consistency across each KOTS application. As such, makefiles in each application directory are ignored in the repository.

Developer Setup

  1. Create a fork of this repository.
  2. On your Vendor account (create one, if needed), create an API token from the Teams and Tokens page:

  3. Ensure the token has "Write" access or you'll be unable create new releases.
  4. Configure the REPLICATED_API_TOKEN github secret in your forked repository (see configuring secrets for more details.
  5. Set the REPLICATED_API_TOKEN in your local environment (e.g., export REPLICATED_API_TOKEN=...)
  6. Go to the directory of the desired application (e.g., nginx-ingress) and copy the default makefile to the current directory.
  7. Ensure the CLI is working by running make list-releases
  8. To iterate on your application, simply push changes to the repository onto the master branch or a new branch. When changes are detected in the app-slug/manifests directory, a github action will initiate to make a new release on the channel of the same name.
  9. To release a beta version of your application, simply push a new tag to the master branch starting with v followed by valid semver format (e.g., v1.0.1). Tags that aren't in this format will be ignored. When this tag is detected, a github action will initiate to make a new release on the "Beta" channel across all applications. Alternatively, you can use the built-in semver functionality and run make tag-next-release

Creating a new kotsapp

  1. Run the following script: `./common/init-new-app.sh <app_name>'. This will create a new directory for the app_name and populate with initial content (including github actions workflow).
  2. Push the new app to github to create your first release on the 'Unstable' channel: git push origin master
  3. In vendor web, create a license for Unstable channel and place in the root of the application directory. Once stable and beta releases are available, you can do the same for those channels as well (License.yaml, License-Unstable.yaml, License-Beta.yaml).

Tools reference

License

MIT