Managing Docker Credentials

Use these tutorials to add, edit, and delete Docker credentials in Saagie projects.

Adding Docker Credentials

Some types of jobs and apps use Docker images. When a Docker image is private, Docker credentials must be provided for your Saagie platform to access the image.

  1. Click The "Projects" module icon is a folder. Projects from the primary navigation menu.
    By default, the The "All Projects" page icon is a folder and the same as the "Projects" module. All Projects page opens with the list of existing projects.

  2. Click a project in the list to open it.
    By default, the The "Jobs" page icon is a 3D pyramid of three squares. Jobs page opens with the list of existing jobs.

    Navigate to your project

  3. Click docker Docker credentials from the secondary navigation menu.
    The page opens with the list of existing credentials.

  4. Click Create credentials to add new Docker credentials.
    A panel opens that you can edit.

  5. Enter the required information.

    The Credentials type field offers two options: Docker Hub and Private Docker Registry.
    If you choose Private Docker Registry, you will need to provide information about your registry.

  6. Click Save to confirm the creation.

    Your Docker credentials are now saved in your project and can be used in jobs and custom apps.

Deleting Docker Credentials

  1. Click the credentials you want to delete.

  2. In the right-hand panel that opens, click delete Delete Credentials.
    A confirmation message appears.

  3. Click Delete again to confirm the deletion.
    Be careful, because there is no progress bar to cancel the deletion once it is confirmed. Besides, deleting credentials used by jobs or custom apps can cause them problems.

Modifying Docker Credentials Information

Whenever you change your Docker credentials on Docker Hub, you must update them in your Saagie project.

  1. Click The "Projects" module icon is a folder. Projects from the primary navigation menu.
    By default, the The "All Projects" page icon is a folder and the same as the "Projects" module. All Projects page opens with the list of existing projects.

  2. Click a project in the list to open it.
    By default, the The "Jobs" page icon is a 3D pyramid of three squares. Jobs page opens with the list of existing jobs.

    Navigate to your project

  3. Click docker Docker credentials from the secondary navigation menu.
    The page opens with the list of existing credentials.

  4. Click the Docker credentials you want to change in the list.
    A panel opens that you can edit.

  5. Change the information as needed.

  6. Click Save to save your changes.