Create and populate a remote catalog
- learn about catalog types
- create your own gitlab or github catalog.
- deploy a solution to the catalog
- learn how to update catalogs
Now that you have written your first solutions, it is time to share it with the world! As you know from before, Album uses catalogs to share solutions. Catalogs are Git repositories collecting solutions. They can live locally on your hard drive or in a remote Git repository, hosted for example on Gitlab or GitHub.
In general, there are two different types of catalogs:
- direct catalogs:
- When deploying (registering) a solution to a direct catalog it will be immediately accessible to anyone who uses this catalog.
- request catalogs:
- Solutions deployed to a request catalog have to be reviewed by the administrators of the catalog (e.g. the Maintainer of the catalog repository)
- After successful review they can be added to the catalog.
- Create an empty repository:
- Log in into your preferred Git instance and create an empty repository.
- Use Album to clone the repository:
- This automatically initializes the repository to become a catalog.
- Please make sure your repo URL ends with ".git"
album clone template:catalog [repo-url] [catalog-name]
Add the newly created catalog to your collection:
- For Album to recognise your new catalog you have to add it to your local collection of catalogs.
- Use the following command:
album add-catalog [repo-url]
Deploy your solution into the catalog:
- You can now address your catalog by the name you chose in step 2 and deploy solutions to it
- Simply run the following command:
album deploy [solution-path] [catalog-name]
Upgrade your local version of the catalog
- Your solution is now part of the remote catalog (e.g. check it in github/gitlab). To synchronise
your local catalog managed by Album with the remote, run the following commands:
album update [catalog-name] album upgrade [catalog-name]
That's it! You created a ready to use catalog and can deploy solutions into it!
Just leave a comment in the box below after signing in with GitHub. Any feedback is highly appreciated.