Managing Repositories

Use these tutorials to add, update, revert, modify, and delete repositories in the Technology Catalog.

The processes are similar for URL and ZIP repositories but not exactly the same. The difference is mainly in the creation process and some other details, which will be mentioned in the corresponding steps.

Creating Repositories

You can create repositories by fetching them from a URL or by uploading a dedicated Zip archive directly on Saagie.

  1. Click The "Catalog" module icon is a bento button. Catalog from the primary navigation menu.
    By default, the The "Repositories" page icon is two plugs being plugged. Repositories page opens.

  2. Click Install a repository from the The "Repositories" page icon is two plugs being plugged. Repositories page to add a new repository to the list.

  3. You can choose between:

    • Upload a Zip archive on Saagie

    • Fetch your repository from a URL

    Create a Zip archive of your repository and upload it on Saagie.

    The .zip file size limit is 10 Mo.

    1. Click Upload Zip archive.

    2. Enter a name for your repository. It must be unique and up to 255 characters.

    3. Click Choose file and select the required Zip archive in your file explorer.

    4. Click Install a repository.
      You are returned to the The "Repositories" page icon is two plugs being plugged. Repositories page updated with the newly added repository.
      The initial synchronization of your repository is done automatically based on the information that you provided in the .zip file.

    Store your repository on a hosting platform and synchronize it with updates.

    1. Click Fetch from URL.

    2. Enter a name for your repository. It must be unique and up to 255 characters.

    3. Enter the URL of the repository where you stored the .zip file.

      The .zip file size limit is 10 Mo.
      You can use any HTTP server without authentication. For example, Saagie’s technology repository is exposed through a GitHub .zip file accessible via the following URL: https://github.com/saagie/technologies/releases/latest/download/technologies.zip.

    4. Click Install a repository.
      You are returned to the The "Repositories" page icon is two plugs being plugged. Repositories page updated with the newly added repository.

Updating Repositories

You can add, update, and delete your technologies by updating them in your repository.

Performing updates to your Technology Catalog can have unexpected consequences for existing jobs, pipelines, and apps. If a job, pipeline, or app uses a technology or technology context that has been changed or deleted by an update, it will not be able to run. Depending on the situation, you may need to modify or delete the job, pipeline, or app and recreate it before continuing.

  1. Click The "Catalog" module icon is a bento button. Catalog from the primary navigation menu.
    By default, the The "Repositories" page icon is two plugs being plugged. Repositories page opens, listing the existing repositories.

  2. From the list, click the repository you want to update to access its details.
    The repository The "Overview" page icon is a square divided into several other squares. Overview page opens. This page displays information about the last update, such as when it was performed, by whom, how many technologies were updated, and how many times the repository was updated.

  3. Click Update technologies to update your repository.
    A window opens and informs you that the update will add, update, and remove technologies according to the changes made to the .zip file you selected.

  4. You can:

    • If you uploaded a .zip file directly from Saagie, you have to upload the new .zip file.

    • If you fetched your repository from a URL, you can edit the URL if the .zip file has been moved. It will redirect you to the repository settings. Edit the URL and click Save.

  5. Click Update technologies to validate.
    A progress bar is displayed while the technologies are updating.

    You can stop the update before it is complete by clicking Cancel the update below the progress bar.

Your repository is updated and you can track all the updates on its The "History" page icon is a counterclockwise arrow. History page.

Repository Update
Figure 3: Repository Update

Reverting Updates

If you add, update, or delete a technology by mistake, no worries! You can undo the update by reverting to the previous version of the repository.

Performing reverts to your Technology Catalog can have unexpected consequences for existing jobs, pipelines, and apps. If a job, pipeline, or app uses a technology or technology context that has been changed or deleted by a revert, it will not be able to run. Depending on the situation, you may need to modify or delete the job, pipeline, or app and recreate it before continuing.

  1. Click The "Catalog" module icon is a bento button. Catalog from the primary navigation menu.
    By default, the The "Repositories" page icon is two plugs being plugged. Repositories page opens, listing the existing repositories.

  2. From the list, click the repository you want to update to access its details.
    The repository The "Overview" page icon is a square divided into several other squares. Overview page opens.

  3. Click The "History" page icon is a counterclockwise arrow. History from the secondary navigation menu.
    The The "History" page icon is a counterclockwise arrow. History page opens. It gives you the history and allows you to keep track of the updates made.

  4. Click Revert next to the current update to return to the previous version.

    Reverting the technology update

    A message appears to warn you that reverting the update of your repository will delete the current update. The deleted update is no longer available and this action cannot be undone. However, you can update your technologies again with the same .zip file by repeating the manual update procedure.

  5. Select the checkbox and click Confirm revert to validate.

You may find yourself in a situation where you need to revert to an earlier update of your repository. Note that you can only revert to the update that immediately precedes the current version of your repository. If you need to revert to an earlier update, revert several times until you reach the correct version.

Deleting Repositories

Deleting a repository disable all jobs and apps using the technologies in that repository.

  1. Click The "Catalog" module icon is a bento button. Catalog from the primary navigation menu.
    By default, the The "Repositories" page icon is two plugs being plugged. Repositories page opens, listing the existing repositories.

  2. From the list, click the repository you want to update to access its details.
    The repository The "Overview" page icon is a square divided into several other squares. Overview page opens.

  3. Click The settings icon is a gear. Repository settings in the right-hand corner of the The "Overview" page icon is a square divided into several other squares. Overview or The "History" page icon is a counterclockwise arrow. History pages of the repository.

  4. Click the Danger Zone tab.
    This setting allows you to delete your repository.

  5. Click Delete this repository.
    A message appears asking you to confirm the deletion.

  6. OPTIONAL: Select the option to enable job and app deletion. This repository will disable all jobs and apps using the technologies in this repository.

  7. Click Delete this repository again to confirm.

There is a small period during which the deletion is processed and during which you will be able to cancel it.