distribution spec
v1.1.0
Proyek SPEC Distribusi OCI mendefinisikan protokol API untuk memfasilitasi dan membakukan distribusi konten.
Spesifikasi dapat ditemukan di sini.
Repositori ini juga menyediakan jenis GO, dan alat kesesuaian registri. Jenis dan validasi GO harus kompatibel dengan rilis GO saat ini; Rilis GO sebelumnya tidak didukung.
Dokumentasi tambahan tentang bagaimana grup ini beroperasi:
Spek distribusi OCI terkait erat dengan proyek spesifikasi format gambar OCI dan proyek spesifikasi runtime OCI.
Spesifikasi format gambar OCI secara ketat mendefinisikan persyaratan untuk gambar OCI (gambar kontainer), yang terdiri dari manifes, indeks gambar opsional, satu set lapisan sistem file, dan konfigurasi. Skema untuk komponen gambar OCI sepenuhnya didukung oleh API yang ditentukan dalam spesifikasi distribusi OCI.
Spesifikasi Runtime OCI mendefinisikan cara menjalankan wadah "bundel sistem file" yang sepenuhnya melekat pada spesifikasi format gambar OCI. Spesifikasi runtime OCI relevan dengan spesifikasi distribusi OCI karena keduanya mendukung gambar OCI, dan bahwa runtime wadah menggunakan API yang ditentukan dalam spesifikasi distribusi OCI untuk mengambil gambar kontainer yang telah dibangun sebelumnya dan menjalankannya.
Spesifikasi Distribusi OCI (proyek ini) juga dirancang secara umum untuk dimanfaatkan sebagai mekanisme distribusi untuk semua jenis konten. Format manifes yang diunggah, misalnya, tidak perlu mematuhi spesifikasi format gambar OCI selama merujuk gumpalan yang terdiri dari artefak yang diberikan.
Untuk pertanyaan tentang spesifikasi distribusi OCI, silakan lihat FAQ.
Untuk pertanyaan umum tentang OCI, silakan lihat FAQ di situs OCI.
Tonggak sejarah GitHub meletakkan jalan menuju perbaikan di masa depan.
Proyek spesifikasi distribusi mencakup proses dan API untuk membuat prototipe dan pengujian ekstensi ke API distribusi.
Kami mengundang kontribusi, komentar, dan ulasan untuk ekstensi ini. Ekstensi ini hanya akan bergerak maju dengan dukungan signifikan dari pendaftar, klien registri, dan pengguna.
Silakan lihat di sini untuk detail lebih lanjut.
Pengembangan terjadi di GitHub untuk spec. Masalah digunakan untuk bug dan item yang dapat ditindaklanjuti dan diskusi yang lebih lama dapat terjadi di milis.
Spesifikasi dan kode dilisensikan di bawah lisensi Apache 2.0 yang ditemukan dalam file LICENSE repositori ini.
Proyek ini menyambut pengiriman, tetapi tolong beri tahu semua orang apa yang sedang Anda kerjakan.
Sebelum melakukan perubahan nontrivial ke spesifikasi ini, kirim surat ke milis untuk membahas apa yang Anda rencanakan. Ini memberi setiap orang kesempatan untuk memvalidasi desain, membantu mencegah duplikasi upaya, dan memastikan bahwa idenya cocok. Ini juga menjamin bahwa desainnya suara sebelum kode ditulis; Permintaan pull-github bukanlah tempat untuk diskusi tingkat tinggi.
Kesalahan ketik dan kesalahan tata bahasa dapat langsung menuju permintaan tarik. Jika ragu, mulailah dengan daftar surat.
Silakan lihat README Repositori OCI Org untuk informasi terkini tentang kontributor OCI dan jadwal pertemuan pemeliharaan. Anda juga dapat menemukan tautan ke agenda pertemuan dan menit untuk semua pertemuan sebelumnya.
Anda dapat berlangganan dan bergabung dengan milis di grup Google.
Diskusi OCI terjadi di ruang obrolan berikut, yang semuanya dijembatani bersama:
Untuk menjaga konsistensi di seluruh file Markdown di Open Container Spec, semua file harus diformat satu kalimat per baris. Ini memperbaiki dua hal: itu membuat berbeda lebih mudah dengan git dan menyelesaikan perkelahian tentang panjang pembungkus garis. Misalnya, paragraf ini akan menjangkau tiga baris di sumber penurunan harga.
Sign-off adalah garis sederhana di akhir penjelasan untuk tambalan, yang menyatakan bahwa Anda menulisnya atau memiliki hak untuk meneruskannya sebagai patch open-source. Aturannya cukup sederhana: Jika Anda dapat mensertifikasi di bawah ini (dari develeventercertificate.org):
Developer Certificate of Origin
Version 1.1
Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
660 York Street, Suite 102,
San Francisco, CA 94110 USA
Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.
Developer's Certificate of Origin 1.1
By making a contribution to this project, I certify that:
(a) The contribution was created in whole or in part by me and I
have the right to submit it under the open source license
indicated in the file; or
(b) The contribution is based upon previous work that, to the best
of my knowledge, is covered under an appropriate open source
license and I have the right under that license to submit that
work with modifications, whether created in whole or in part
by me, under the same open source license (unless I am
permitted to submit under a different license), as indicated
in the file; or
(c) The contribution was provided directly to me by some other
person who certified (a), (b) or (c) and I have not modified
it.
(d) I understand and agree that this project and the contribution
are public and that a record of the contribution (including all
personal information I submit with it, including my sign-off) is
maintained indefinitely and may be redistributed consistent with
this project or the open source license(s) involved.
Maka Anda cukup menambahkan baris ke setiap pesan komit git:
Signed-off-by: Jane Smith <[email protected]>
Menggunakan nama asli Anda (maaf, tidak ada nama samaran atau kontribusi anonim.)
Anda dapat menambahkan tanda mati saat membuat komit git melalui git commit -s .
Penjaga rumah sederhana untuk riwayat git bersih. Baca lebih lanjut tentang cara menulis pesan komitmen git atau bagian diskusi git-commit(1) .
