Administrator User Interface

The role of the administrators is to manage the organisation resources and users. In particular, the admin will be able to perform the following operations:

• Select the Control Version System and configure its connection to AIchor;
• Add projects from GitHub or GitLab or BitBucket;
• Create a new project and link a Git repo;
• Assign seats and Invite users to the project.

The organisation and login pages of the AIchor platform looks like the following:

Add VCS Providers

AIchor needs to have access to the preferred Version Control System (VCS) provider of the organisation to pull the repos from. Currently, AIchor supports GitHub, GitLab and BitBucket. Upon first login into the AIchor platform, the administrator will need to click on the “Version Control System” link located in the top menu to configure the access to the platform of the version control system providers where the repositories are located.

For GitLab, the steps are as follows:
After selecting GitLab and entering a different url if needed, then clicking on button “Next” redirects the administrator to a form where he will need to enter the name, application ID and secret ID. Then he will need to click on the button “Create” for the VCS connection to be established.

The Application details need to be directly generated from the GitHub/GitLab user interface.

• Click on the link next to "register a new OAuth Application", and a new tab on Gitlab will be opened;

• On that page, enter:

  • Click "Add new application" button
  • Enter a Name;
  • Redirect URI: This is the URL where users are sent after they authorize with GitLab;
  • Under “Scopes”, tick the option “api” that grants complete read/write access to the API including all groups and projects, the container registry, and the package registry.

• After clicking the “Save application” button the administrator will be taken to the new application page where he will be able to get the Application and Secret IDs:

  • The OAuth 2 Client ID in the Application ID field;
  • The OAuth 2 Client Secret, accessible: In the Secret field in GitLab 14.1 and earlier. Using the Copy button on the Secret field in GitLab 14.2 and later.

• Copy the application ID and secret ID on AIchor along with the same name entered on GitLab and click "Create".

For GitHub, the steps are as follows:

NOTE An administrator on GitHub needs to create the VCS on AIchor and provide access to relevant repositories.

• Click "Next"

• Click on the link next to "register a new OAuth Application", and a new tab on GitHub will be opened;

• On that page, enter:

  • Application name;

• Enter the app name on AIchor

• Select whether to access selected repositories or all the repositories in GitHub Organisation.

For BitBucket, the steps are as follows:

• Open the BitBucket account and go to the considered workspace as detailed on AIchor page and select Add OAuth consumer;

• On the consumer page, enter:

  • Name;
  • Callback URL from AIchor page;
  • URL from AIchor page;

• After clicking "Save", the administrator will be taken to a page where he will be able to get the key and Secret;

• Copy the key and secret on AIchor along with the same name entered on BitBucket and click "Create".

Delete VCS

The administrator will be able to delete the Version Control System linked to his organisation (only if there are no projects associated) by clicking on the “Version Control System” link on the top menu:

Projects Dashboard

The Projects Dashboard is accessible from the top menu by clicking on “Projects”. The first time the administrator logs into the interface the project dashboard will be empty. On successive occasions and after creating projects, the administrator will be presented with the list of the projects that are part of his organisation. The list will be made up of the project name, the project creation date and a link to the Git repo from where it has been pulled. The administrator is able to filter on the names of the projects.

Create New Project

On the left hand side of the menu, and after clicking on the “Create new project” button, the administrator will be guided through the project creation wizard, which is made up of the following steps:

• “Connect to project”: The admin will be asked to enter a name for the project and to select the Version Control System provider he wants to connect to. After clicking on “Next”, he will need to select a repo from the VCS provider;

• “Select Repo”: The admin user will need to click on the desired repository from the displayed list. The list has been pulled from GitLab/GitHub after the administrator provided his connection details. There is a filtering option provided for quick access. To continue with the set-up, the admin should click on the “Next” button;

• “Select Members”: After selecting a repository in the previous step of the workflow, the list of users assigned to the repo will automatically be fetched from GitHub/GitLab. The information displayed per user is made up of the following fields:

  • GitHub/GitLab avatar;
  • Full name.

In addition to those fields, there is an input text form so the administrator can introduce the email address of the user of his organisation he wants to assign a seat in AIchor Platform. Note that by default there are allowed up to five seats per project. The administrator should click on the checkbox menu item to select users and click on “Create”.

When a project is created in AIchor, project members will receive two types of notifications via email. One is an invitation to join the organisation and create an account. The second indicates that they are now members of a project in AIchor. Note the following:

• The username of the AIchor account will be the email address of the user;
• The provided link will be generated with an expiration time of 2 days;
• In this initial version of the AIchor platform the administrator will not be able to remove or change the users. This functionality will be added in future versions.

Edit/Delete Project

The administrator can only add more users if the project still has free seats. A "Users Available seats" counter is available.

He can also delete a project only if it has no experiments.

The administrator will soon be able to set resource limits for the project by configuring the number of CPUs/GPUs and memory size from the “Settings” option of the top menu. In addition, the administrator can select the checkbox called “Limitation Settings” to decide whether or not he wants to have limits (restrictions on the resources). This is valid for all experiments whatever the project. To validate the changes the admin will need to click on the “Save Changes” button. Alternatively he can opt for the “Discard Changes” if he wants to cancel the changes.

Cluster management

In the settings section, the user can create GKE kubernetes clusters on GCP, Slurm is yet to come.

In the case of a cluster to be created on GCP, maximum CPU and Memory values have to be specified.

In order to be able to spin up nodes with GPUs, CPU and memory maximum fields have to meet some requirements at the cluster level that would allow the auto-scaler to spin up the needed nodes when an experiment is triggered.

These requirements are dictated by GCP nodes specifications: https://cloud.google.com/compute/docs/gpus#nvidia_gpus_for_compute_workloads