imgpkg

imgpkg

• Sitio web: https://carvel.dev/imgpkg
• Slack: #carvel en Kubernetes Slack
• Documentos con ejemplo de flujo de trabajo y otros detalles
• Instalar: tome archivos binarios prediseñados desde la página Lanzamientos o toque Homebrew Carvel
• Trabajo pendiente: vea lo que estamos haciendo.

imgpkg (pronunciado: "paquete de imágenes") es una herramienta que permite a los usuarios almacenar un conjunto de archivos arbitrarios como una imagen OCI. Uno de los casos de uso más importantes es almacenar la configuración de Kubernetes (YAML simple, plantillas de ytt, plantillas de Helm, etc.) en el registro OCI como una imagen.

El concepto principal de imgpkg es un paquete, que es una imagen OCI que contiene 0+ archivos arbitrarios y 0+ referencias a imágenes OCI dependientes. Con este concepto, imgpkg puede copiar paquetes y sus imágenes dependientes entre registros (tanto en línea como fuera de línea).

$ 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

Características:

• Permite enviar un paquete que contiene un conjunto de archivos y una lista de imágenes de las que dependen.
• Permite extraer un paquete y extraer el mismo conjunto de archivos y lista de referencias de imágenes.
• Permite copiar un paquete en formato grueso (es decir, imagen del paquete + todas las imágenes a las que se hace referencia) en un repositorio o tarball.
• Compatibilidad con entornos aislados mediante comando de copia
• Permite enumerar etiquetas de imágenes enviadas
• Utiliza el tipo de medio de capa Docker para trabajar con registros existentes
• Utiliza permisos de archivos deterministas y marcas de tiempo para hacer que las imágenes sean reproducibles (el mismo resumen si nada cambió)

Únase a la comunidad y mejore Carvel

Carvel es mejor gracias a nuestros contribuyentes y mantenedores. Es gracias a usted que podemos ofrecer un excelente software a la comunidad. Únase a nosotros durante nuestras reuniones comunitarias en línea. Los detalles se pueden encontrar en nuestro sitio web de Carvel.

Puede chatear con nosotros en Kubernetes Slack en el canal #carvel y seguirnos en Twitter en @carvel_dev.

Vea qué organizaciones utilizan y contribuyen a Carvel: lista de adoptantes

Desarrollo

Construye el código con

./hack/build.sh

Pruebas

Ejecute todas las pruebas con un registro local (requiere Docker)

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

Si desea utilizar un registro de proxy para extraer imágenes a fin de evitar la limitación de velocidad de Dockerhub, configure la variable de entorno DOCKERHUB_PROXY en ese proxy, por ejemplo:

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

Cambios en el código fuente

Para mantener actualizada la documentación del código fuente, imgpkg utiliza godoc. Para documentar un tipo, variable, constante, función o paquete, escriba un comentario regular directamente antes de su declaración que comience con el nombre del elemento que describe. Vea el paquete de registro para ver un ejemplo. Al contribuir con nuevo código fuente a través de un PR, el linter de acción de GitHub garantizará que los documentos godocs se incluyan en los cambios.

Para ver los documentos

1. Instale godoc: go install golang.org/x/tools/cmd/godoc@latest
2. Inicie el servidor: godoc -http=:6060 y visite http://localhost:6060/pkg/carvel.dev/imgpkg/ .