Skip to main content
Version: 23.4

Kubernetes

Kubernetes is the leading technology for the deployment and orchestration of containerized workloads in cloud-native environments.

Seqera Platform streamlines the deployment of Nextflow pipelines into Kubernetes, both for cloud-based and on-prem clusters.

The following instructions create a Seqera compute environment for a generic Kubernetes distribution. See Amazon EKS or Google GKE for EKS and GKE compute environment instructions.

Cluster preparation​

To prepare your Kubernetes cluster for the deployment of Nextflow pipelines using Seqera, this guide assumes that you've already created the cluster and that you have administrative privileges.

Prepare your Kubernetes cluster for Seqera Platform

  1. Verify the connection to your Kubernetes cluster:

    kubectl cluster-info

  2. Download the tower-launcher.yml file.

  3. Create the Seqera launcher:

    kubectl apply -f path/to/tower-launcher.yml

    This command creates a service account called tower-launcher-sa and the associated role bindings, all contained in a namespace called tower-nf. Seqera uses the service account to launch Nextflow pipelines. Use this service account name when setting up the compute environment for this Kubernetes cluster in Seqera.

  4. Create persistent storage. Seqera requires a ReadWriteMany persistent volume claim (PVC) mounted to all nodes where workflow pods will be dispatched.

    You can use any storage solution that supports the ReadWriteMany access mode. The setup of this storage is beyond the scope of these instructions — the right solution for you will depend on what is available for your infrastructure or cloud vendor (NFS, GlusterFS, CephFS, Amazon FSx). Ask your cluster administrator for more information.

  5. Apply the appropriate PVC configuration to your cluster:

    kubectl apply -f <PVC_YAML_FILE>.

Seqera compute environment​

After you've prepared your Kubernetes cluster for Seqera integration, create a compute environment:

Create a Seqera Kubernetes compute environment

  1. In a workspace, select Compute environments > New environment.
  2. Enter a descriptive name for this environment, e.g., K8s cluster.
  3. Select Kubernetes as the target platform.
  4. From the Credentials drop-down, select existing Kubernetes credentials, or select + to add new credentials. If you choose to use existing credentials, skip to step 7.

You can create multiple credentials in your Seqera workspace. See Credentials.

  1. Enter a name, e.g., K8s Credentials.

  2. Select either the Service Account Token or X509 Client Certs tab:

    • To authenticate using a Kubernetes service account, enter your Service account token. Obtain the token with the following command:

      SECRET=$(kubectl get secrets | grep <SERVICE-ACCOUNT-NAME> | cut -f1 -d ' ')
      kubectl describe secret $SECRET | grep -E '^token' | cut -f2 -d':' | tr -d '\t'

      Replace <SERVICE-ACCOUNT-NAME> with the name of the service account created in the cluster preparation instructions (default: tower-launcher-sa).

    • To authenticate using an X509 client certificate, paste the contents of your certificate and key file (including the -----BEGIN...----- and -----END...----- lines) in the Client certificate and Client Key fields respectively. See the Kubernetes documentation for instructions to generate your client certificate and key.

  3. Enter the Control plane URL, obtained with this command:

    kubectl cluster-info

    It can also be found in your ~/.kube/config file under the server field corresponding to your cluster.

  4. Specify the SSL certificate to authenticate your connection.

    Find the certificate data in your ~/.kube/config file. It is the certificate-authority-data field corresponding to your cluster.

  5. Specify the Namespace created in the cluster preparation instructions, which is tower-nf by default.

  6. Specify the Head service account created in the cluster preparation instructions, which is tower-launcher-sa by default.

  7. Specify the Storage claim created in the cluster preparation instructions, which serves as a scratch filesystem for Nextflow pipelines. The storage claim is called tower-scratch in each of the provided examples.

  8. Apply Resource labels to the cloud resources consumed by this compute environment. Workspace default resource labels are prefilled.

  9. Expand Staging options to include optional pre- or post-run Bash scripts that execute before or after the Nextflow pipeline execution in your environment.

  10. You can use the Environment variables option to specify custom environment variables for the Head job and/or Compute jobs.

  11. Configure any advanced options described below, as needed.

  12. Select Create to finalize the compute environment setup.

See Launch pipelines to start executing workflows in your Kubernetes compute environment.

Advanced options​

Seqera Platform compute environments for Kubernetes include advanced options for storage and work directory paths, resource allocation, and pod customization.

Seqera Kubernetes advanced options

  • The Storage mount path is the file system path where the Storage claim is mounted (default: /scratch).

  • The Work directory is the file system path used as a working directory by Nextflow pipelines. It must be the storage mount path (default) or a subdirectory of it.

  • The Compute service account is the service account used by Nextflow to submit tasks (default: the default account in the given namespace).

  • The Pod cleanup policy determines when to delete terminated pods.

  • Use Custom head pod specs to provide custom options for the Nextflow workflow pod (nodeSelector, affinity, etc). For example:

spec:
   nodeSelector:
      disktype: ssd

  • Use Custom service pod specs to provide custom options for the compute environment pod. See above for an example.

  • Use Head Job CPUs and Head Job memory to specify the hardware resources allocated to the Nextflow workflow pod.