imgpkg

Site Web : https://carvel.dev/imgpkg
Slack : #carvel dans Kubernetes Slack
Documents avec un exemple de flux de travail et d'autres détails
Installer : récupérez les binaires prédéfinis à partir de la page des versions ou appuyez sur Homebrew Carvel
Carnet de commandes : découvrez ce que nous faisons.

imgpkg (prononcé : "package d'images") est un outil qui permet aux utilisateurs de stocker un ensemble de fichiers arbitraires sous forme d'image OCI. L'un des cas d'utilisation principaux consiste à stocker la configuration de Kubernetes (YAML simple, modèles ytt, modèles Helm, etc.) dans le registre OCI en tant qu'image.

Le concept principal d'imgpkg est un bundle, qui est une image OCI contenant plus de 0 fichiers arbitraires et 0+ références à des images OCI dépendantes. Avec ce concept, imgpkg est capable de copier des bundles et leurs images dépendantes dans des registres (en ligne et hors ligne).

$ imgpkg push -b your-user/app1-config:0.1.1 -f config/
$ imgpkg copy -b your-user/app1-config:0.1.1 --to-repo other-user/app1
$ imgpkg pull -b your-user/app1-config:0.1.1 -o /tmp/app1-config
$ imgpkg tag ls -i your-user/app1-config

Caractéristiques:

Permet de pousser un bundle contenant un ensemble de fichiers, et une liste d'images dont ils dépendent
Permet d'extraire un bundle et d'extraire le même ensemble de fichiers et la même liste de références d'images
Permet de copier un bundle en gros plan (c'est-à-dire l'image du bundle + toutes les images référencées) vers un dépôt ou une archive tar
Prise en charge de l'environnement Air Gap via la commande de copie
Permet de lister les balises d'image poussées
Utilise le type de support de couche Docker pour fonctionner avec les registres existants
Utilise des autorisations de fichiers déterministes et des horodatages pour rendre les images reproductibles (même résumé si rien n'a changé)

Rejoignez la communauté et améliorez Carvel

Carvel est meilleur grâce à nos contributeurs et mainteneurs. C'est grâce à vous que nous pouvons apporter d'excellents logiciels à la communauté. Rejoignez-nous lors de nos réunions communautaires en ligne. Les détails peuvent être trouvés sur notre site Web Carvel.

Vous pouvez discuter avec nous sur Kubernetes Slack sur la chaîne #carvel et nous suivre sur Twitter à @carvel_dev.

Découvrez quelles organisations utilisent et contribuent à Carvel : liste des adoptants

Développement

Construisez le code avec

./hack/build.sh

Essai

Exécutez chaque test avec un registre local (nécessite Docker)

./hack/test-all-local-registry.sh 5000

Si vous souhaitez utiliser un registre proxy pour extraire des images afin d'éviter la limitation de débit de Dockerhub, définissez la variable d'environnement DOCKERHUB_PROXY sur ce proxy, par exemple :

 export DOCKERHUB_PROXY= < my-registry.local.sometld/my-dockerhub-proxy > && ./hack/test-all-local-registry.sh 5000

Modifications du code source

Pour maintenir la documentation du code source à jour, imgpkg utilise godoc. Pour documenter un type, une variable, une constante, une fonction ou un package, écrivez un commentaire régulier précédant directement sa déclaration qui commence par le nom de l'élément qu'il décrit. Voir le package de registre pour un exemple. Lors de la contribution d'un nouveau code source via un PR, le linter GitHub Action garantira que les godocs sont inclus dans les modifications.

Pour consulter les documents

installez godoc : go install golang.org/x/tools/cmd/godoc@latest
Démarrez le serveur : godoc -http=:6060 et visitez http://localhost:6060/pkg/carvel.dev/imgpkg/ .

Développer

Informations supplémentaires