Siapkan dan Pelajari GIT

[ English | English (United Kingdom) | español (México) | 한국어 (대한민국) | 中文 (简体, 中国) | Deutsch | Indonesia ]

Siapkan dan Pelajari GIT

Catatan

Bagian ini mengasumsikan Anda telah menyelesaikan panduan Account Setup (pengaturan akun).

GIT

Apa itu Git?

Git adalah sistem kontrol versi terdistribusi gratis dan open source yang digunakan komunitas OpenStack untuk mengelola perubahan kode sumber dan dokumentasi.

Git memungkinkan Anda untuk:

Instalasi

Mac OS

  1. Lihat ke Git download page dan klik Mac OS X.

  2. File yang diunduh harus berupa dmg di folder unduhan Anda. Buka file dmg itu dan ikuti instruksi di layar.

Jika Anda menggunakan manajer paket Homebrew <http://brew.sh> _, buka terminal dan ketik

brew install git

Linux

Untuk distribusi seperti Debian, Ubuntu, atau Mint buka terminal dan ketik

sudo apt install git

Untuk distribusi seperti RedHat, Fedora 21 atau sebelumnya, atau CentOS buka terminal dan ketik

sudo yum install git

Untuk Fedora 22 atau lebih baru buka terminal dan ketik

sudo dnf install git

Untuk distribusi SUSE, buka terminal dan ketik

sudo zypper in git

Windows

Windows Subsystem for Linux (WSL) tersedia di Windows 10 Anniversary Update atau yang lebih baru (build 1607+). Ada kemungkinan untuk menginstal dan menjalankan Sistem Operasi Linux modern:

Semua alat umum seperti bash, git, dan SSH akan berfungsi di out of the box.

Meskipun Git download page menyediakan biner instalasi Windows, sebagian besar alat pengembangan OpenStack (misal, git-review) sayangnya tidak akan berfungsi dengan baik di lingkungan Windows.

Konfigurasikan Git

Setelah Anda menginstal Git, Anda perlu mengkonfigurasinya. Buka aplikasi terminal Anda dan keluarkan perintah berikut dengan memasukkan nama depan / belakang dan alamat email Anda. Beginilah kontribusi Anda akan diidentifikasi

git config --global user.name "Firstname Lastname"
git config --global user.email "your_email@youremail.com"

Catatan

Gunakan alamat email yang sama yang digunakan selama pengaturan akun.

Belajar Git

Anda dapat menggunakan Git Immersion <http://gitimmersion.com/lab_02.html> _ untuk mengerjakan tutorial untuk mempelajari git.

Untuk referensi, gunakan Git Reference and Cheat Sheet.

Pesan Komit

Pesan komit adalah hal pertama yang dilihat oleh pengulas dan digunakan sebagai deskripsi di git log. Mereka memberikan deskripsi tentang sejarah perubahan dalam repositori. Pesan komit tidak dapat diubah setelah patch digabungkan.

Format:

  • Summary Line

  • Empty line

  • Body

  • Empty line

  • Tags

Catatan

Tag harus dimasukkan satu per baris.

Summary Line

Baris ringkasan menjelaskan secara singkat konten patch. Batas karakter adalah 50 karakter. Baris ringkasan tidak boleh diakhiri dengan titik. Jika perubahan belum selesai pada saat komit, mulai pesan komit dengan WIP.

Body

Body berisi penjelasan tentang masalah yang sedang dipecahkan dan mengapa hal itu harus diperbaiki, deskripsi solusi, dan informasi tambahan opsional tentang bagaimana hal itu meningkatkan struktur kode, atau referensi ke patch lain yang relevan, misalnya. Garis dibatasi hingga 72 karakter. Body harus memuat semua informasi penting yang terkait dengan masalah, tanpa berasumsi bahwa pembaca memahami sumber masalah atau memiliki akses ke situs eksternal.

Tags

Tag adalah referensi yang digunakan untuk menautkan perubahan ke alat lain.

Tag berikut diperlukan:

  • Baris Change-id adalah hash unik yang menggambarkan perubahan, yang dihasilkan secara otomatis oleh kait komit Git. Ini tidak boleh diubah ketika memunculkan kembali komit setelah umpan balik ulasan, karena digunakan oleh Gerrit, untuk melacak versi patch.

StoryBoard specific tags:

  • Task: 1234: the number of the task in Storyboard implemented by the change. This will auto update the task to 'Review' status and assign it to you when you push the patch.

  • Story: 1234567: the number of the story in Storyboard to which the task being implemented belongs. This will post a comment on the story with a link to your patch.

Launchpad specific tags:

  • Closes-Bug: #123456789: menggunakan Closes-Bug jika komit dimaksudkan untuk sepenuhnya memperbaiki dan menutup bug yang dirujuk. Gunakan ID Launchpad bug untuk nomor; Gerrit secara otomatis membuat tautan ke bug.

  • Partial-Bug: #123456789: menggunakan Partial-Bug jika komit hanya memperbaiki sebagian dan lebih banyak pekerjaan diperlukan. Gunakan ID Launchpad bug untuk nomor; Gerrit secara otomatis membuat tautan ke bug.

  • Related-Bug: #12456789: menggunakan 'Related-Bug' jika komit hanya terkait dengan bug yang dirujuk. Gunakan ID Launchpad bug untuk nomor; Gerrit secara otomatis membuat tautan ke bug.

  • Partial-Implements: Gunakan tag ini jika perubahan mengimplementasikan sebagian blueprint Launchpad. Gunakan nama blueprint sebagai ID.

  • Implements: Gunakan tag ini jika perubahan sepenuhnya mengimplementasikan blueprint Launchpad. Gunakan nama blueprint sebagai ID.

Tag berikut adalah opsional; Namun, penggunaannya disarankan jika berlaku untuk patch:

  • Tag DocImpact berisi komentar tentang mengapa perubahan berdampak pada dokumentasi. Letakkan DocImpact di baris dengan sendirinya. Gunakan tag ini untuk menunjukkan bahwa dokumentasi terkandung dalam patch atau memiliki dampak dokumentasi. Ketika tag ini disertakan dalam pesan komit, Gerrit membuat bug untuk proyek yang dipengaruhi oleh perubahan untuk pelacakan tugas, atau pindah ke openstack-api-site sesuai kebutuhan.

  • Tag APIImpact berisi komentar tentang mengapa perubahan berdampak pada HTTP API publik. Letakkan APIImpact di baris dengan sendirinya. Gunakan tag ini untuk menunjukkan bahwa patch berdampak pada API HTTP publik. Saat tag ini disertakan dalam pesan komit, API_Working_Group dapat menggunakannya untuk membantu menemukan ulasan yang relevan.

  • Tag SecurityImpact digunakan untuk menunjukkan bahwa perubahan memiliki implikasi keamanan dan harus ditinjau oleh OpenStack Security Group.

  • Tag UpgradeImpact berisi komentar tentang mengapa perubahan ini berdampak pada peningkatan. Ini digunakan untuk menunjukkan bahwa perubahan memiliki implikasi peningkatan bagi mereka yang melakukan penyebaran berkelanjutan atau peningkatan N ke N+1. Juga pertimbangkan untuk memperbarui bagian 'Upgrade Notes' di catatan rilis untuk proyek yang terpengaruh.

  • Tag Depends-On: <gerrit-change-url> digunakan untuk merujuk pada perubahan yang bergantung pada saat ini. Gunakan tautan permanen perubahan.

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.