Manage project

A recording session includes all files related to a single recording session. Recording files (multiple files if recording multiple buses), configuration files, media files.

If you head over to Manage project you see a list of all the users in this project as well as some tools to manage them. This is also where you delete the project.

How-to select project

Console

Simply click the navigation path Manage project.

Cli

When you are working with project specific things in CLI you use --project my_project to specify project or you can set a default project by setting environment variable REMOTIVE_CLOUD_PROJECT.

remotive cloud brokers list --project my-project

export REMOTIVE_CLOUD_PROJECT=my-project
remotive cloud brokers list

You can list your projects using this command

remotive cloud projects list --organisation my-organisation

Projects

---

Projects contain users, recording sessions, signal databases and brokers.

Create project

How-to create project

Console

Step 1

Click the "add project" button.

Step 2

Fill the required input fields and press "Create project"

Cli

$ remotive cloud projects create --organisation my-organisation --project-uid my-new-project

Delete project

All resources including recordings, brokers etc must have been removed from the project before it can be deleted.

How-to delete project

Console

Click the "Delete" button.

Cli

$ remotive cloud projects delete --project my-project-to-delete

Users

---

Here you add users that you want to collaborate with to your project.

Adding users is currently not supported with the CLI.

Add user to project

How-to add a user

Edit user

You can change roles assigned to user

How-to edit user roles

Remove user

How-to remove a user

Service accounts

---

This is where you manage service accounts for the current project. Service accounts are non-personal accounts that can be used to access RemotiveCloud resources in e.g. CI/CD pipelines. Unlike personal access tokens, service account tokens are limited to the project the service account was created in.

Create service account

How-to create a service account

Console

Step 1

Step 2

Cli

List service accounts

$ remotive cloud service-accounts list --project my-project
[{
    "creator": "John Doe",
    "created": "2023-06-27T12:49:29.540+02:00",
    "name": "ci-service-account",
    "roles": [
        "project/viewer"
    ]
}]

Create service account

You create a service account by defining a name and one or more roles

$ remotive cloud service-accounts create my-service-account \
  --role 'project/user'  --project my-project

Edit service account

How-to edit a service account

Console

Step 1

Step 2

Cli

You update a service account by defining a name and one or more roles. You must supply all roles that you want to have for each update that's done

$ remotive cloud service-accounts update my-service-account \
  --role 'project/viewer'  --project my-project

Delete service account

Deleting a service account revokes all access from that account and also removes all tokens belonging to that service account.

How-to delete a service account

Console

Cli

$ remotive cloud service-accounts delete my-service-account \
  --project my-project

Create access token

To access a project's resources the service account must use a service account access token. You can create and download multiple tokens for a single service account.

How-to create a access token

Console

Step 1

Step 2

Cli

Using this command downloads an access token file to your home directory

$ remotive cloud service-accounts tokens create \
  --service-account my-service-account \
  --project beamyhack
Secret token written to /HOME/.config/.remotive/service-account-my-service-account-87AEC65AFA381BC9-token.json

Revoke access token

To minimize risk of a token being compromised its recommended to rotate access token sometimes and be sure to revoke tokens that are no longer needed.

How-to revoke an access token

Console

Step 1

Step 2

Cli

$ remotive cloud service-accounts tokens revoke 87AEC65AFA381BC9 \
  --service-account my-service-account \
  --project my-project