GitHub Bağlantısı

Bu kılavuz, tam kurulum sürecini açıklar: GitHub hesabınızı Atoms'a bağlama, depoyu oluşturma, bağlantının çalıştığını doğrulama ve projenizin Atoms ve GitHub sürümlerini senkronize tutma.

Bağlantı nasıl çalışır

GitHub'a bağlanmanın 2 aşaması vardır:

1. GitHub hesabınızı bağlayın. Bu, Atoms'a sizin adınıza GitHub ile çalışma izni verir.
2. Projeniz için bir depo oluşturun. Depo, GitHub'da projenizin kodunun ve değişiklik geçmişinin saklandığı özel alandır.

Atoms şu anda bağlı kullanıcının kişisel GitHub hesabında yeni bir özel depo oluşturur. Mevcut bir depoya bağlanamaz, depoyu bir kuruluş altında oluşturamaz veya bağlayıcı üzerinden herkese açık hale getiremezsiniz.

Başlamadan önce

Projenizi GitHub'a bağlamadan önce şunlardan emin olun:

• Atoms planınız GitHub bağlantısını içeriyor. Free plandaysanız, GitHub'ı seçmek sizi Plans sayfasına götürür.
• GitHub'ı yalnızca çalışma alanı sahibi bağlayabilir veya bağlantısını kesebilir. Düzenleyiciyseniz, bu adımı gerçekleştirmesi için çalışma alanı sahibinden istekte bulunun.
• Bir GitHub hesabınız var veya kurulum sırasında bir tane oluşturmaya hazırsınız.
• Tarayıcınız Atoms'tan gelen açılır pencerelere izin veriyor.
• Şu anda hiçbir Agent projeniz üzerinde çalışmıyor.

Hesabınızı bağlamak için bir GitHub personal access token'ına ihtiyacınız yoktur. GitHub token'larını, parolaları veya diğer kimlik bilgilerini asla Sohbet'e yapıştırmayın.

GitHub hesabınızı bağlayın

GitHub bağlayıcısını açın

1. Bağlamak istediğiniz projeyi açın.
2. Sohbet panelinin sağ üst kısmındaki proje adına tıklayın.
3. Açılan açılır menüden Connectors seçeneğini seçin.
4. Kullanılabilir bağlayıcılar listesinde Github öğesini bulun ve connect seçeneğine tıklayın.

Ayrıca Settings → Connectors → GitHub yolunu açıp Connect seçeneğini de seçebilirsiniz.

Settings → Connectors bölümünü açın ve GitHub için Connect seçeneğini seçin.

GitHub'da Atoms'u yetkilendirin

Connected Account zaten kullanmak istediğiniz GitHub hesabını gösteriyorsa, hesap zaten yetkilendirilmiştir. Özel bir depo oluşturun bölümüne devam edebilirsiniz.

1. Atoms bir GitHub yetkilendirme penceresi açar. Bağlamak istediğiniz GitHub hesabında oturum açın veya gerekirse yeni bir hesap oluşturun.
2. Doğru GitHub hesabında oturum açtığınızı kontrol edin.
3. Atoms tarafından istenen izinleri gözden geçirin. Kabul ediyorsanız Authorize Atoms-Agents seçeneğini seçin.
4. Atoms'a geri dönün ve Connect success mesajını bekleyin.
5. Atoms'ta Connectors bölümünü açın ve GitHub hesabınızın bağlı olarak göründüğünü doğrulayın.

Atoms, repo, read:user ve workflow OAuth izinlerini ister. Bunlar, Atoms'un bağlı hesabın erişebildiği herkese açık ve özel depoları okumasına ve yazmasına, temel profil bilgilerini okumasına ve GitHub Actions iş akışı dosyalarını eklemesine veya güncellemesine olanak tanır.

Bu yetkilendirme bağlı GitHub hesabı için geçerlidir ve mevcut Atoms projesi için oluşturulan depoyla sınırlı değildir. Atoms, bağlı hesabın kendisinin erişemediği depolara erişemez ve kuruluş politikaları ek kısıtlamalar getirebilir.

GitHub izinlerini gözden geçirin ve Authorize Atoms-Agents seçeneğini seçin.

Özel bir depo oluşturun

GitHub hesabınızı yetkilendirdikten sonra, projenizin kodunu depolayacak özel depoyu oluşturun.

1. Connected Account altında, görüntülenen kullanıcı adının kullanmak istediğiniz GitHub hesabıyla eşleştiğini kontrol edin.
2. Create New Repository altında, depo için bir ad girin. Ad şunları karşılamalıdır:
   • 1–100 karakter içermelidir;
   • yalnızca harfler, rakamlar, kısa çizgiler (-), alt çizgiler (_) veya noktalar (.) kullanmalıdır.
3. Create seçeneğini seçin.
4. GitHub repository connected successfully! mesajını bekleyin.

Atoms, bağlı kullanıcının kişisel GitHub hesabında yeni bir özel depo oluşturur, bunu mevcut Atoms projesine bağlar ve ardından projenin mevcut dosyalarını GitHub'a yüklemeye çalışır.

Bir ad girin ve yeni bir özel depo oluşturun.

Bağlantının çalıştığını kontrol edin

Depoya güvenmeden önce bağlantıyı hem Atoms'ta hem de GitHub'da kontrol edin.

1. Atoms'ta Repository Status alanının Connected gösterdiğini doğrulayın.
2. Branches altında, bir dalın onay işaretine sahip olduğunu kontrol edin. Bu, şu anda Atoms projenize bağlı olan daldır. GitHub'a yeniyseniz, bu dalı seçili tutun.
3. View on GitHub seçeneğini seçin.
4. GitHub'da deponun şunları doğruladığını kontrol edin:
   • doğru GitHub hesabına ait olduğunu;
   • Private olarak işaretlendiğini;
   • beklenen proje dosyalarını içerdiğini; ve
   • en az bir commit içerdiğini.

Depo boşsa ve Atoms'ta Push Changes kullanılabiliyorsa, bunu seçin ve işlemin tamamlanmasını bekleyin. Ardından GitHub'daki depo sayfasını yenileyin ve proje dosyalarının artık göründüğünü kontrol edin.

Atoms'ta bağlı depoyu ve seçili dalı kontrol edin.

GitHub'da özel depoyu ve proje dosyalarını doğrulayın.

Atoms ve GitHub'ı senkronize tutun

Atoms ve GitHub otomatik olarak senkronize kalmaz. Bir tarafta değişiklik yapıldığında, bu değişiklikleri diğer tarafa taşımak için senkronizasyon denetimlerini kullanın.

Action	Ne zaman kullanılır	Ne olur
Push Changes	Atoms'ta değişiklik yaptınız ve bunları GitHub'a göndermek istiyorsunuz.	Atoms, mevcut proje dosyalarını seçili GitHub dalına gönderir.
Pull Updates	GitHub'da seçili dalda değişiklikler yapıldı ve bunları Atoms'a almak istiyorsunuz.	Atoms, projeyi GitHub'daki en son değişikliklerle günceller.

Değişiklikleri göndermeden veya çekmeden önce, Agent'ın işi bitirmesini bekleyin ve Sohbet'te projenin en son sürümünü görüntülediğinizden emin olun. History içinden daha eski bir sürümü açtıysanız, Sohbet'in alt kısmındaki en son sürüm kartına dönün, ardından GitHub'ı yeniden açın.

En son sürümde değilseniz, Atoms You must be on the latest version to pull updates or push changes. mesajını gösterir.

Senkronizasyondan önce, seçili dalın güncellemek istediğiniz dal olduğundan da emin olun.

Hem Atoms hem de GitHub'da korumanız gereken değişiklikler varsa, henüz bunları senkronize etmeyin. Önce önemli çalışmanın bir kopyasını kaydedin veya GitHub'a aşina birinden değişiklikleri ayrı bir dalda korumasını isteyin.

Repository Status alanında Upstream Changes Available görünüyorsa, GitHub'da Atoms'un henüz sahip olmadığı değişiklikler vardır. Bir işlem seçmeden önce depoyu gözden geçirin.

Seçili dal için Pull Updates ve Push Changes seçeneklerini kullanın.

Değişiklikleri Atoms'tan GitHub'a gönderin

1. Atoms'ta değişikliklerinizi tamamlayın ve Agent'ın çalışmayı bırakmasını bekleyin.
2. Projenin en son sürümünü görüntülediğinizden emin olun.
3. Settings → Connectors → GitHub bölümünü açın ve doğru dalın seçili olduğunu kontrol edin.
4. Push Changes seçeneğini seçin.
5. Değişiklikler gönderilirken sayfayı açık tutun.
6. Changes pushed successfully göründüğünde, View on GitHub seçeneğini seçin ve en son proje dosyalarının orada olduğunu kontrol edin.

Push Changes yalnızca Atoms'ta henüz GitHub'a gönderilmemiş değişiklikler olduğunda kullanılabilir. Agent çalışırken veya projenin daha eski bir sürümünü görüntülerken kullanılamaz.

Push Changes seçeneğini belirlediğiniz anda, onay istenmeden değişiklikler hemen GitHub'a gönderilir. Aynı dosya hem Atoms'ta hem de GitHub'da değiştirilmişse, Atoms'taki sürüm önceliklidir ve şu anda GitHub'da depolanan sürümün üzerine yazılır.

Güncellemeleri GitHub'dan Atoms'a çekin

Göndermenin aksine, değişiklikleri çekmek önce onay gerektirir. Aynı dosya hem GitHub'da hem de Atoms'ta değiştirilmişse, GitHub sürümü önceliklidir ve Atoms'taki mevcut sürümün üzerine yazılır.

1. Settings → Connectors → GitHub bölümünü açın.
2. Repository Status alanının GitHub'dan gelen yeni değişiklikleri gösterdiğini ve doğru dalın seçili olduğunu kontrol edin.
3. Pull Updates seçeneğini seçin.
4. Pull May Affect Project uyarısını okuyun. GitHub değişikliklerini mevcut Atoms projenize almak istiyorsanız Confirm seçeneğini seçin.
5. Değişiklikler çekilirken sayfayı açık tutun.
6. Changes pulled successfully göründüğünde, Uygulama Görüntüleyici'ni açın ve her şeyin beklendiği gibi çalıştığından emin olmak için projenizin değişikliklerden etkilenen bölümlerini test edin.

Pull Updates yalnızca seçili GitHub dalı henüz Atoms'a alınmamış değişiklikler içerdiğinde kullanılabilir.

GitHub bağlantısını kesin

Atoms'un bağlı hesaba erişmesini artık istemediğinizde GitHub bağlantısını kesin. GitHub deposu ve dosyaları GitHub'da kalır, ancak Atoms artık değişiklikleri gönderemez veya çekemez.

GitHub yetkilendirmesi bağlı hesap için geçerlidir. Erişimi iptal etmek, o GitHub hesabını kullanan tüm Atoms projelerinin bağlantısını keser; bu nedenle devam etmeden önce diğer projelerinizi kontrol edin.

1. Settings → Connectors → GitHub bölümünü açın.
2. Disconnect seçeneğini seçin.
3. Disconnect GitHub onayında tekrar Disconnect seçeneğini seçin.
4. GitHub ilgili yetkilendirme sayfasını otomatik olarak açmalıdır. Açmazsa, GitHub'da Settings → Applications → Authorized OAuth Apps bölümüne gidin.
5. Atoms öğesini bulun, satırının sağındaki ... seçeneğini seçin, ardından Revoke seçeneğini seçin. Revoke all seçeneğini seçmeyin; bu işlem sayfada listelenen yetkilendirilmiş tüm OAuth uygulamalarının erişimini kaldırır.
6. Github'dan gereken tüm onay adımlarını tamamlayın.
7. Atoms'a dönün ve hesabın artık bağlı olmadığını doğrulamak için GitHub bağlayıcısını yeniden açın.

GitHub bağlayıcısında Disconnect seçeneğini seçin.

GitHub'da yalnızca Atoms OAuth uygulamasını iptal edin.