Packages
Vos images de conteneur, gardées à côté du code qui les construit. Toboggan est un registre : podman, Docker, skopeo et containerd y poussent et en tirent, et toute machine qui a une clé peut faire tourner vos images.
Le nom d’une image
<hôte>/<propriétaire>/<nom>:<tag>, le propriétaire étant votre nom ou
celui d’un igloo, en minuscules : toboggan.cloud/acme/api:latest. Un
package peut porter le nom d’un dépôt, et c’est souvent le cas.
Une clé
Dans vos réglages, sous Jetons personnels, créez un jeton et choisissez ce qu’il ouvre :
- Packages : tirer pour un serveur qui fait tourner vos images ;
- Packages : tirer et pousser pour une CI hors de Toboggan.
Ni l’un ni l’autre n’ouvre vos dépôts, Git ou les assistants : donnez à une machine le moins qu’il lui faut. Puis :
podman login toboggan.cloud -u vous --password-stdin # collez le jeton
Pousser
podman build -t toboggan.cloud/acme/api:latest .
podman push --compression-format zstd toboggan.cloud/acme/api:latest
Le premier push crée le package, privé. Un workflow d’un dépôt pousse avec son propre jeton, sans secret : son package est alors lié au dépôt et en a l’accès. Le workflow d’une pull request tire, ne pousse jamais.
Seul ce qui est tagué est gardé
Une version qu’aucun tag ne nomme est supprimée dans l’heure : quand
latest avance, la version qu’il nommait part. Taguez ce que vous
voulez garder : latest, et un tag par version publiée (v1.4.0). Un
tag par commit garderait l’image de chaque commit, et remplirait votre
espace (3 Go par propriétaire, les couches communes comptées une fois).
Tirer sur un serveur
podman login toboggan.cloud -u vous --password-stdin
podman pull toboggan.cloud/acme/api:v1.4.0
Pour suivre latest, un quadlet avec AutoUpdate=registry et
systemctl --user enable --now podman-auto-update.timer : podman tire
la nouvelle version et redémarre le service, et revient à l’ancienne si
la nouvelle ne démarre pas. Il ne défait pas une migration de base de
données : c’est à vous de la prévoir.
Qui voit un package
Lié à un dépôt, il en a l’accès : qui lit le dépôt tire l’image, qui y
écrit la pousse. Non lié, il est à son propriétaire, et sa visibilité
(public, interne, privé) dit qui d’autre le tire. La page du package,
/packages/<propriétaire>/<nom>, montre ses tags et la commande qui le
tire ; son admin le lie à un dépôt, change sa visibilité ou le supprime.
Une copie, pas une sauvegarde
Le registre n’est pas sauvegardé. Une image se reconstruit à partir de son dépôt : gardez-y ce qui la construit.