Hubungkan proyek Atoms Anda ke GitHub untuk menyimpan kodenya di repositori privat dan memindahkan perubahan antara Atoms dan GitHub tanpa menggunakan perintah Git.

Panduan ini menjelaskan proses penyiapan lengkap: menghubungkan akun GitHub Anda ke Atoms, membuat repositori, memastikan bahwa koneksi berfungsi, dan menjaga versi proyek Anda di Atoms dan GitHub tetap sinkron.

Cara kerja koneksi

Ada 2 tahap untuk menghubungkan GitHub:

1. Hubungkan akun GitHub Anda. Ini memberi Atoms izin untuk bekerja dengan GitHub atas nama Anda.
2. Buat repositori untuk proyek Anda. Repositori adalah ruang privat di GitHub tempat kode dan riwayat perubahan proyek Anda disimpan.

Saat ini Atoms membuat repositori privat baru di akun GitHub pribadi milik pengguna yang terhubung. Anda tidak dapat terhubung ke repositori yang sudah ada, membuat repositori di bawah organisasi, atau menjadikannya publik melalui konektor.

Sebelum memulai

Sebelum menghubungkan proyek Anda ke GitHub, pastikan bahwa:

• Paket Atoms Anda mencakup koneksi GitHub. Jika Anda menggunakan paket Free, memilih GitHub akan membawa Anda ke halaman Plans.
• Hanya pemilik workspace yang dapat menghubungkan atau memutuskan GitHub. Jika Anda seorang editor, minta pemilik workspace untuk melakukan langkah ini.
• Anda memiliki akun GitHub atau siap membuatnya selama penyiapan.
• Browser Anda mengizinkan jendela pop-up dari Atoms.
• Tidak ada Agen yang sedang mengerjakan proyek Anda.

Anda tidak memerlukan token akses pribadi GitHub untuk menghubungkan akun Anda. Jangan pernah menempelkan token GitHub, kata sandi, atau kredensial lainnya ke Chat.

Hubungkan akun GitHub Anda

Buka konektor GitHub

1. Buka proyek yang ingin Anda hubungkan.
2. Klik nama proyek di kanan atas panel chat.
3. Pilih Connectors di menu drop-down yang muncul.
4. Temukan Github di daftar konektor yang tersedia, lalu klik connect.

Anda juga dapat membuka Settings → Connectors → GitHub dan memilih Connect.

Buka Settings → Connectors dan pilih Connect untuk GitHub.

Otorisasi Atoms di GitHub

Jika Connected Account sudah menampilkan akun GitHub yang ingin Anda gunakan, berarti akun tersebut sudah diotorisasi. Anda dapat melanjutkan ke Create a private repository.

1. Atoms membuka jendela otorisasi GitHub. Masuk ke akun GitHub yang ingin Anda hubungkan, atau buat akun baru jika diperlukan.
2. Periksa bahwa Anda masuk ke akun GitHub yang benar.
3. Tinjau izin yang diminta oleh Atoms. Jika Anda setuju, pilih Authorize Atoms-Agents.
4. Kembali ke Atoms dan tunggu pesan Connect success.
5. Di Atoms, buka Connectors dan pastikan akun GitHub Anda muncul sebagai terhubung.

Atoms meminta izin OAuth repo, read:user, dan workflow. Izin ini memungkinkan Atoms membaca dan menulis repositori publik dan privat yang dapat diakses oleh akun yang terhubung, membaca informasi profil dasar, serta menambahkan atau memperbarui file workflow GitHub Actions.

Otorisasi ini berlaku untuk akun GitHub yang terhubung dan tidak terbatas pada repositori yang dibuat untuk proyek Atoms saat ini. Atoms tidak dapat mengakses repositori yang tidak dapat diakses oleh akun yang terhubung itu sendiri, dan kebijakan organisasi dapat memberlakukan pembatasan tambahan.

Tinjau izin GitHub dan pilih Authorize Atoms-Agents.

Buat repositori privat

Setelah mengotorisasi akun GitHub Anda, buat repositori privat yang akan menyimpan kode proyek Anda.

1. Di bawah Connected Account, periksa bahwa nama pengguna yang ditampilkan cocok dengan akun GitHub yang ingin Anda gunakan.
2. Di bawah Create New Repository, masukkan nama untuk repositori. Nama tersebut harus:
   • berisi 1–100 karakter;
   • hanya menggunakan huruf, angka, tanda hubung (-), garis bawah (_), atau titik (.).
3. Pilih Create.
4. Tunggu pesan GitHub repository connected successfully!.

Atoms membuat repositori privat baru di akun GitHub pribadi milik pengguna yang terhubung, menautkannya ke proyek Atoms saat ini, lalu mencoba mengunggah file proyek saat ini ke GitHub.

Masukkan nama dan buat repositori privat baru.

Periksa bahwa koneksi berhasil

Periksa koneksi di Atoms dan GitHub sebelum mengandalkan repositori tersebut.

1. Di Atoms, pastikan Repository Status menampilkan Connected.
2. Di bawah Branches, periksa bahwa satu branch memiliki tanda centang. Ini adalah branch yang saat ini terhubung ke proyek Atoms Anda. Jika Anda baru menggunakan GitHub, biarkan branch ini tetap dipilih.
3. Pilih View on GitHub.
4. Di GitHub, pastikan repositori tersebut:
   • milik akun GitHub yang benar;
   • ditandai sebagai Private;
   • berisi file proyek yang diharapkan; dan
   • memiliki setidaknya satu commit.

Jika repositori kosong dan Push Changes tersedia di Atoms, pilih itu dan tunggu hingga operasi selesai. Lalu segarkan halaman repositori di GitHub dan periksa bahwa file proyek sekarang muncul.

Periksa repositori yang terhubung dan branch yang dipilih di Atoms.

Verifikasi repositori privat dan file proyek di GitHub.

Jaga Atoms dan GitHub tetap sinkron

Atoms dan GitHub tidak tetap sinkron secara otomatis. Saat perubahan telah dibuat di salah satu sisi, gunakan kontrol sinkronisasi untuk memindahkan perubahan tersebut ke sisi lainnya.

Tindakan	Gunakan saat	Apa yang terjadi
Push Changes	Anda membuat perubahan di Atoms dan ingin mengirimkannya ke GitHub.	Atoms mengirim file proyek saat ini ke branch GitHub yang dipilih.
Pull Updates	Perubahan dibuat pada branch yang dipilih di GitHub dan Anda ingin membawanya ke Atoms.	Atoms memperbarui proyek dengan perubahan terbaru dari GitHub.

Sebelum Anda melakukan push atau pull perubahan, tunggu Agen selesai dan pastikan Anda sedang melihat versi terbaru proyek di Chat. Jika Anda membuka versi lama dari History, kembali ke kartu versi terbaru di bagian bawah Chat, lalu buka kembali GitHub.

Jika Anda tidak berada pada versi terbaru, Atoms menampilkan You must be on the latest version to pull updates or push changes.

Sebelum menyinkronkan, periksa juga bahwa branch yang dipilih adalah branch yang ingin Anda perbarui.

Jika Atoms dan GitHub sama-sama berisi perubahan yang perlu Anda pertahankan, jangan sinkronkan keduanya dulu. Simpan salinan pekerjaan penting terlebih dahulu, atau minta seseorang yang memahami GitHub untuk mempertahankan perubahan tersebut di branch terpisah.

Jika Repository Status menampilkan Upstream Changes Available, GitHub berisi perubahan yang belum dimiliki Atoms. Tinjau repositori sebelum memilih tindakan.

Gunakan Pull Updates dan Push Changes untuk branch yang dipilih.

Push perubahan dari Atoms ke GitHub

1. Selesaikan perubahan Anda di Atoms dan tunggu Agen berhenti bekerja.
2. Pastikan Anda sedang melihat versi terbaru proyek.
3. Buka Settings → Connectors → GitHub dan periksa bahwa branch yang benar dipilih.
4. Pilih Push Changes.
5. Biarkan halaman tetap terbuka saat perubahan sedang di-push.
6. Saat Changes pushed successfully muncul, pilih View on GitHub dan periksa bahwa file proyek terbaru ada di sana.

Push Changes hanya tersedia saat Atoms memiliki perubahan yang belum dikirim ke GitHub. Opsi ini tidak tersedia saat Agen sedang bekerja atau saat Anda sedang melihat versi proyek yang lebih lama.

Setelah Anda memilih Push Changes, perubahan langsung dikirim ke GitHub tanpa meminta konfirmasi. Jika file yang sama telah diubah di Atoms dan GitHub, versi di Atoms akan diprioritaskan dan akan menimpa versi yang saat ini tersimpan di GitHub.

Pull pembaruan dari GitHub ke Atoms

Berbeda dengan push, pull perubahan memerlukan konfirmasi terlebih dahulu. Jika file yang sama telah diubah di GitHub dan Atoms, versi GitHub akan diprioritaskan dan akan menimpa versi saat ini di Atoms.

1. Buka Settings → Connectors → GitHub.
2. Periksa bahwa Repository Status menampilkan perubahan baru dari GitHub dan bahwa branch yang benar dipilih.
3. Pilih Pull Updates.
4. Baca peringatan Pull May Affect Project. Jika Anda ingin membawa perubahan GitHub ke proyek Atoms Anda saat ini, pilih Confirm.
5. Biarkan halaman tetap terbuka saat perubahan sedang di-pull.
6. Saat Changes pulled successfully muncul, buka Penampil App dan uji bagian proyek Anda yang terdampak oleh perubahan untuk memastikan semuanya masih berfungsi seperti yang diharapkan.

Pull Updates hanya tersedia saat branch GitHub yang dipilih berisi perubahan yang belum dibawa ke Atoms.

Putuskan GitHub

Putuskan GitHub saat Anda tidak lagi ingin Atoms mengakses akun yang terhubung. Repositori GitHub dan file-filenya akan tetap ada di GitHub, tetapi Atoms tidak lagi dapat melakukan push atau pull perubahan.

Otorisasi GitHub berlaku untuk akun yang terhubung. Mencabut akses akan memutus setiap proyek Atoms yang menggunakan akun GitHub tersebut, jadi periksa proyek Anda yang lain sebelum melanjutkan.

1. Buka Settings → Connectors → GitHub.
2. Pilih Disconnect.
3. Di konfirmasi Disconnect GitHub, pilih Disconnect lagi.
4. GitHub seharusnya membuka halaman otorisasi yang relevan secara otomatis. Jika tidak, di GitHub buka Settings → Applications → Authorized OAuth Apps.
5. Temukan Atoms, pilih ... di sebelah kanan barisnya, lalu pilih Revoke. Jangan pilih Revoke all; tindakan itu menghapus akses untuk setiap app OAuth yang diotorisasi yang tercantum di halaman tersebut.
6. Ikuti langkah konfirmasi apa pun yang diperlukan dari Github.
7. Kembali ke Atoms dan buka kembali konektor GitHub untuk memastikan bahwa akun tersebut tidak lagi terhubung.

Pilih Disconnect di konektor GitHub.

Cabut hanya aplikasi OAuth Atoms di GitHub.