tobogganSe connecter

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 :

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.