Creating and Managing Technologies
To add new technologies to the catalog, you have to:
You can manage the added technologies afterwards by updating the technologies in your repository. |

Creating Metadata Files for Your Technologies
-
Create the
metadata.yaml
ormetadata.yml
file:External technologies require a more advanced setup with additional information on how to establish a connection with the external service and how the life cycle of the external job instance must be executed. You can use the attribute reference tables and the metadata example files to create metadata files. -
Save your file(s) according to the following architecture:
-
The job, app, and external technologies are in separate folders, which are grouped in a main folder.
-
The job, app, and external technology folders have subdirectories for each technology.
-
Each technology subdirectory has its own
metadata.yaml
file.External technologies must include the referenced JavaScript files. Figure 2: Folder hierarchy
-
-
Compress the main folder in
.zip
format.Your
.zip
file can contain several types of files but only files namedmetadata.yaml
ormetadata.yml
will be processed.For example, you can create a zip archive with the contents of the Saagie technology repository using the following command line:
zip technologies.zip -r technologies/
Creating a Repository
-
Click the
Catalog module.
By default, theRepositories page opens.
-
Click Add Repository to add a new repository to the list.
-
You can choose between:
Create a zip archive of your repository and upload it on Saagie.
-
Click Upload zip archive.
-
Enter a name for your repository.
It must be unique and up to 255 characters. -
Click Choose file and select the required zip archive in your file explorer.
-
Click Add repository.
You are returned to the 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 and synchronize it with updates.
-
Click Fetch from URL.
-
Enter a name for your repository.
It must be unique and up to 255 characters. -
Enter the URL of the repository where you stored the
.zip
file.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. -
Click Add repository.
You are returned to the Repositories page updated with the newly added repository.
-