admin-console generate-manifests

Running this command will create a directory on the workstation containing the Replicated Admin Console manifests. These assets can be used to deploy KOTS to a cluster through other workflows, such as kubectl, to provide additional customization of the Admin Console before deploying.

Limitations

• generate-manifests does not support generating manifests for Red Hat OpenShift clusters or GKE Autopilot clusters if executed without a Kubernetes cluster context.

• To upgrade a KOTS instance that has ever been on version 1.72.0 or earlier, you must run generate-manifests with a Kubernetes cluster context.

• The admin-console generate-manifests command does not accept the --strict-security-context flag, which deploys KOTS Pods with a security context. To generate Admin Console manifests with a security context, add the following to the Pod templates for Deployments and StatefulSets deployed by KOTS:

  securityContext:
    fsGroup: 1001
    runAsGroup: 1001
    runAsNonRoot: true
    runAsUser: 1001
    seccompProfile:
      type: RuntimeDefault
    supplementalGroups:
    - 1001

Usage

kubectl kots admin-console generate-manifests [flags]

This command supports the following flags:

Flag	Type	Description
--rootdir	string	Root directory where the YAML will be written (default ${HOME} or %USERPROFILE%)
--namespace	string	Target namespace for the Admin Console
--shared-password	string	Shared password to use when deploying the Admin Console
--http-proxy	string	Sets HTTP_PROXY environment variable in all KOTS Admin Console components
--http-proxy	string	Sets HTTP_PROXY environment variable in all KOTS Admin Console
--kotsadm-namespace	string	Set to override the registry namespace of KOTS Admin Console images. Used for air gap installations. For more information, see Air Gap Installation in Existing Clusters. Note: Replicated recommends that you use --kotsadm-registry instead of --kotsadm-namespace to override both the registry hostname and, optionally, the registry namespace with a single flag.
--kotsadm-registry	string	Set to override the registry hostname and namespace of KOTS Admin Console images. Used for air gap installations. For more information, see Air Gap Installation in Existing Clusters.
--no-proxy	string	Sets NO_PROXY environment variable in all KOTS Admin Console components
--private-ca-configmap	string	Name of a ConfigMap containing private CAs to add to the kotsadm deployment
--registry-password	string	Password to use to authenticate with the application registry. Used for air gap installations.
--registry-username	string	Username to use to authenticate with the application registry. Used for air gap installations.
--with-minio	bool	Set to true to include a local minio instance to be used for storage (default true)
--minimal-rbac	bool	Set to true to include a local minio instance to be used for storage (default true)
--additional-namespaces	string	Comma delimited list to specify additional namespace(s) managed by KOTS outside where it is to be deployed. Ignored without with --minimal-rbac=true
--storage-class	string	Sets the storage class to use for the KOTS Admin Console components. Default: unset, which means the default storage class will be used

Examples

kubectl kots admin-console generate-manifests
kubectl kots admin-console generate-manifests --rootdir ./manifests
kubectl kots admin-console generate-manifests --namespace kotsadm --minimal-rbac=true --additional-namespaces="app1,app3"