tw credentials

To launch pipelines in a Platform workspace, you need credentials for:

1. Compute environments
2. Pipeline repository Git providers
3. (Optional) Tower agent — used with HPC clusters
4. (Optional) Container registries, such as docker.io

tw credentials add

Add workspace credentials.

tw credentials add [OPTIONS]

Run tw credentials add -h to view a list of providers.

Run tw credentials add <provider> -h to view the required fields for your provider.

note

You can add multiple credentials from the same provider in the same workspace.

Compute environment credentials

Platform requires credentials to access your cloud compute environments. See the [compute environment page][compute-envs] for your cloud provider for more information.

tw credentials add aws --name=my_aws_creds --access-key=<aws access key> --secret-key=<aws secret key>

  New AWS credentials 'my_aws_creds (1sxCxvxfx8xnxdxGxQxqxH)' added at user workspace

Git credentials

Platform requires access credentials to interact with pipeline Git repositories. See [Git integration][git-integration] for more information.

tw credentials add github -n=my_GH_creds -u=<GitHub username> -p=<GitHub access token>

  New GITHUB credentials 'my_GH_creds (xxxxx3prfGlpxxxvR2xxxxo7ow)' added at user workspace

Container registry credentials

Configure credentials for the Nextflow Wave container service to authenticate to private and public container registries. See Container registry credentials for more information.

note

Container registry credentials are only used by the Wave container service. See Wave containers for more information.

tw credentials add container-reg --name=my_registry_creds --username=<registry username> --password=<registry password> --registry=docker.io

  New CONTAINER-REG credentials 'my_registry_creds (2tyCywygy9yoyeyHyRyryI)' added at user workspace

tw credentials update

Update workspace credentials.

tw credentials update [OPTIONS]

Run tw credentials update -h to view a list of providers.

Run tw credentials update <provider> -h to view the required fields for your provider.

Example

tw credentials update aws -n aws-credentials -a AKIAIOSFODNN7EXAMPLE -w 123456789012345

# Output:
  AWS credentials 'aws-credentials' updated at [my-organization / my-workspace] workspace

tw credentials delete

Delete workspace credentials.

tw credentials delete [OPTIONS]

Options

Option	Description	Required	Default
-i, --id	Credentials unique identifier
-n, --name	Credentials name
-w, --workspace	Workspace numeric identifier or reference in OrganizationName/WorkspaceName format (defaults to TOWER_WORKSPACE_ID environment variable)		${TOWER_WORKSPACE_ID}

tw credentials delete --name=my_aws_creds

  Credentials '1sxCxvxfx8xnxdxGxQxqxH' deleted at user workspace

tw credentials list

List workspace credentials.

tw credentials list [OPTIONS]

Options

Option	Description	Required	Default
-w, --workspace	Workspace numeric identifier or reference in OrganizationName/WorkspaceName format (defaults to TOWER_WORKSPACE_ID environment variable)		${TOWER_WORKSPACE_ID}

tw credentials list

  Credentials at user workspace:

    ID                     | Provider  | Name                               | Last activity
    ------------------------+-----------+------------------------------------+-------------------------------
    1x1HxFxzxNxptxlx4xO7Gx | aws       | my_aws_creds_1                     | Wed, 6 Apr 2022 08:40:49 GMT
    1sxCxvxfx8xnxdxGxQxqxH | aws       | my_aws_creds_2                     | Wed, 9 Apr 2022 08:40:49 GMT
    2x7xNsf2xkxxUIxXKxsTCx | ssh       | my_ssh_key                         | Thu, 8 Jul 2021 07:09:46 GMT
    4xxxIeUx7xex1xqx1xxesk | github    | my_github_cred                     | Wed, 22 Jun 2022 09:18:05 GMT