gambar.imgpkg

Situs web: https://carvel.dev/imgpkg
Slack: #carvel di Kubernetes kendur
Dokumen dengan contoh alur kerja dan detail lainnya
Instal: Ambil biner bawaan dari halaman Rilis atau ketuk Homebrew Carvel
Backlog: Lihat apa yang sedang kami lakukan.

imgpkg (diucapkan: "paket gambar") adalah alat yang memungkinkan pengguna menyimpan sekumpulan file arbitrer sebagai gambar OCI. Salah satu kasus penggunaan yang mendorong adalah menyimpan konfigurasi Kubernetes (YAML biasa, templat ytt, templat Helm, dll.) di registri OCI sebagai gambar.

Konsep utama imgpkg adalah bundel, yang merupakan gambar OCI yang menampung 0+ file arbitrer dan 0+ referensi ke gambar OCI yang bergantung. Dengan konsep ini, imgpkg dapat menyalin bundel dan gambar dependennya di seluruh registri (baik online maupun offline).

$ 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

Fitur:

Memungkinkan untuk mendorong bundel yang berisi sekumpulan file, dan daftar gambar yang menjadi sandarannya
Memungkinkan untuk menarik bundel dan mengekstrak kumpulan file dan daftar referensi gambar yang sama
Memungkinkan untuk menyalin bundel secara tebal (yaitu gambar bundel + semua gambar yang direferensikan) ke repo atau tarball
Dukungan lingkungan dengan celah udara melalui perintah salin
Memungkinkan untuk membuat daftar tag gambar yang didorong
Menggunakan jenis media lapisan Docker untuk bekerja dengan registri yang ada
Menggunakan izin file deterministik dan stempel waktu untuk membuat gambar dapat direproduksi (intisari yang sama jika tidak ada yang berubah)

Bergabunglah dengan Komunitas dan Jadikan Carvel Lebih Baik

Carvel menjadi lebih baik karena kontributor dan pengelola kami. Karena Anda, kami dapat menghadirkan perangkat lunak hebat ke komunitas. Silakan bergabung dengan kami selama pertemuan komunitas online kami. Detailnya dapat ditemukan di situs web Carvel kami.

Anda dapat mengobrol dengan kami di Kubernetes Slack di saluran #carvel dan mengikuti kami di Twitter di @carvel_dev.

Lihat organisasi mana yang menggunakan dan berkontribusi pada Carvel: Daftar Adopter

Perkembangan

Bangun kode dengan

./hack/build.sh

Pengujian

Jalankan setiap pengujian dengan registri lokal (memerlukan Docker)

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

Jika Anda ingin menggunakan registri proxy untuk mengambil gambar guna menghindari pembatasan kecepatan dari dockerhub, setel variabel lingkungan DOCKERHUB_PROXY ke proxy tersebut, misalnya:

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

Perubahan Kode Sumber

Untuk selalu memperbarui dokumentasi kode sumber, imgpkg menggunakan godoc. Untuk mendokumentasikan suatu tipe, variabel, konstanta, fungsi, atau paket, tulis komentar reguler tepat sebelum deklarasinya yang dimulai dengan nama elemen yang dideskripsikannya. Lihat paket registri sebagai contoh. Saat menyumbangkan kode sumber baru melalui PR, linter GitHub Action akan memastikan bahwa godocs disertakan dalam perubahan.

Untuk melihat dokumen

instal godoc: go install golang.org/x/tools/cmd/godoc@latest
Mulai server: godoc -http=:6060 dan kunjungi http://localhost:6060/pkg/carvel.dev/imgpkg/ .

Memperluas

Informasi Tambahan