Manage Users

Fluidstack managed Slurm includes user-management features for convenient and secure access to Slurm clusters.

info

Slurm user management is currently a preview feature that is only available in regions that support the slurm:users:* capabilities.

List Users

CLI

Use the fluidctl slurm clusters users list command to list all users on a cluster:

fluidctl slurm clusters users list --region <region> --project <project-id> --cluster-id <cluster-id>

API

To list all users via the API, send a GET request to the /slurm/clusters/{cluster_id}/users endpoint:

GET /slurm/clusters/<cluster-id>/users HTTP/1.1
Host: <region>.atlas.fluidstack.io
Authorization: Bearer <token>

Add User

CLI

Use the fluidctl slurm clusters users add command to add a user to a cluster:

fluidctl slurm clusters users add \
  --region <region> \
  --project <project-id> \
  --cluster-id <cluster-id> \
  --username <username> \
  --ssh-keys "<ssh-public-key>" \
  --sudo

Options:

• --username - Username for the new user (required)
• --ssh-keys - SSH public key(s) for the user (can be specified multiple times)
• --sudo - Grant sudo access to the user

API

To add a user via the API, send a POST request to the /slurm/clusters/{cluster_id}/users endpoint:

POST /slurm/clusters/<cluster-id>/users HTTP/1.1
Host: <region>.atlas.fluidstack.io
Authorization: Bearer <token>
Content-Type: application/json

{
  "username": "<username>",
  "ssh_keys": ["<ssh-public-key>"],
  "sudo": true
}

Get User Details

CLI

Use the fluidctl slurm clusters users describe command to get details of a specific user:

fluidctl slurm clusters users describe --region <region> --project <project-id> --cluster-id <cluster-id> --username <username>

API

To get user details via the API, send a GET request to the /slurm/clusters/{cluster_id}/users/{username} endpoint:

GET /slurm/clusters/<cluster-id>/users/<username> HTTP/1.1
Host: <region>.atlas.fluidstack.io
Authorization: Bearer <token>

Update User

CLI

Use the fluidctl slurm clusters users update command to update a user's SSH keys or sudo access:

fluidctl slurm clusters users update \
  --region <region> \
  --project <project-id> \
  --cluster-id <cluster-id> \
  --username <username> \
  --ssh-keys "<new-ssh-public-key>" \
  --sudo=false

Options:

• --username - Username of the user to update (required)
• --ssh-keys - New SSH public key(s) for the user (can be specified multiple times)
• --sudo - Grant or revoke sudo access

API

To update a user via the API, send a PATCH request to the /slurm/clusters/{cluster_id}/users/{username} endpoint:

PATCH /slurm/clusters/<cluster-id>/users/<username> HTTP/1.1
Host: <region>.atlas.fluidstack.io
Authorization: Bearer <token>
Content-Type: application/json

{
  "ssh_keys": ["<new-ssh-public-key>"],
  "sudo": false
}

Delete User

caution

Deleting a user is irreversible. The user will lose access to the cluster immediately.

CLI

Use the fluidctl slurm clusters users delete command to remove a user from a cluster:

fluidctl slurm clusters users delete --region <region> --project <project-id> --cluster-id <cluster-id> --username <username>

API

To delete a user via the API, send a DELETE request to the /slurm/clusters/{cluster_id}/users/{username} endpoint:

DELETE /slurm/clusters/<cluster-id>/users/<username> HTTP/1.1
Host: <region>.atlas.fluidstack.io
Authorization: Bearer <token>

LDAP Federation

Fluidstack will configure LDAP federation for Slurm clusters on request. Reach out to Fluidstack support for details.