Environment Management

Environments are deployment targets. They are logical groups of cluster + namespace + framework that allow Lens Apps to understand where to deploy an application, and which set of policies to enforce during such deployments (and post-deployment).

πŸ“˜

NOTE

Environments are abstracted away from the user in the Dashboard to simplify the User Experience and reduce the amount of concepts introduced by Lens Apps. However, they are managed under the hood to support multiple features (app deployments, policy enforcement, etc)

Creating an environment

πŸ“˜

Environment prerequisites

In order to create an environment you need to have a cluster previously connected (visit Connecting Clusters) and optionally a framework created (visit Framework Management).

The command below creates a new environment using an existing cluster and framework:

lapps environment create <environment> [-f/--framework] [-c/--cluster] [-n/--namespace] [flags]

Command options:

-c, --cluster The cluster to deploy your app to.
-k, --framework The framework to enforce during app deployments.
-n, --namespace The Namespace to create, generated if not passed within the provided cluster

Flags:

FlagDescription
-c, --cluster(= "") the cluster to deploy/discover apps
-k, --framework(= "") the framework to enforce policies with
-n, --namespace(= "") the namespace to create/use when deploying/discovering apps

Updating environments

To update existing environments, use the command below (indicating the name of the intended resource)

lapps environment update <environment> [flags]

Flags:

FlagDescription
-y, --assume-yes(= false) don't ask for confirmation
-k, --framework(="") the framework to enforce policies with

πŸ“˜

Limitations

At the moment, the update process only supports changing the "name" of the environment and the "framework" associated with it. Other parameters cannot be updated after the environment has been created.

Removing environments

To remove existing environments simply use the environment remove command indicating the name of the environment that wants to be deleted

lapps environment remove <environment> [flags]

Flags

FlagDescription
-y, --assume-yes(= false) don't ask for confirmation