Installing Red Sky Ops

There are two parts to Red Sky Ops: the redskyctl tool and Red Sky Ops Manager (running in your cluster).

Installing the Red Sky Ops Tool

Binary Releases

You can download binaries directly from the releases page.

Using cURL and jq

To download the latest release, select your platform (linux or darwin) and run:

os=linux # Or 'darwin'
curl -s https://api.github.com/repos/redskyops/k8s-experiment/releases/latest |\
  jq -r ".assets[] | select(.name | contains(\"${os:-linux}\")) | .browser_download_url" |\
  xargs curl -L -o redskyctl
chmod +x redskyctl
sudo mv redskyctl /usr/local/bin/

Installing the Red Sky Ops Manager

The Red Sky Ops Manager runs inside your Kubernetes cluster. It can be configured to talk to an Enterprise server for improved capabilities.

Easy Install

To perform an easy install, simply run redskyctl init. This will create a new redsky-system namespace and will create a Kubernetes job to manage the actual installation.

Using redskyctl init is safe for multiple invocations; in fact re-running it with a new version of redskyctl is also the easiest way to upgrade your in cluster components or configuration.

Easy Enterprise Install

If you are subscribing to the Enterprise product, please contact your sales representative for additional configuration prior to running redskyctl init. If you just want to get started, you can always apply the additional configuration later.

Helm Install

If you cannot use redskyctl to install, a basic Helm chart exists. To install using Helm, add the Red Sky Ops repository and install the redskyops chart:

helm repo add redsky https://redskyops.dev/charts/
helm repo update
helm install --namespace redsky-system --name redsky redsky/redskyops

The latest release of the Helm chart may not reference the latest application version, use the redskyTag value to override the application version.

Helm Enterprise Install

The redskyops Helm chart includes additional values to configure when using the Enterprise product, please contact your sales representative for the additional values to use when installing with Helm.

Advanced Installation

If you have specific security requirements or the default RBAC configuration for the easy install is too permissive for your environment, there are a number of ways to obtain the raw Red Sky Ops Manager manifests:

  1. Using redskyctl init --dry-run will print the raw manifests used during installation, however this still requires creating a Kubernetes pod.
  2. Using Docker to run the setuptools image directly. For example, docker container run --rm $(redskyctl version --setuptools) will produce the same output as redskyctl init --dry-run without requiring a configured Kubernetes context.

Upgrading the Red Sky Ops Manager

The preferred way to upgrade the Red Sky Ops Manager is to install the latest version of redskyctl locally and run redskyctl config fix before re-running redskyctl init. Use redskyctl version to check the current version numbers.

In some cases there may be incompatibilities between versions requiring an uninstall prior to the installation of the new version: please consult the release notes for the version you are installing.

Uninstalling the Red Sky Ops Manager

To remove the Red Sky Ops Manager completely from your cluster, run redskyctl reset.

IMPORTANT Running the reset command will also remove all of the Red Sky Ops data. Ensure you have backed up any information in the cluster prior to running this command.