Kodunu özel bir depoda tutmak ve Git komutlarını kullanmadan değişiklikleri Atoms ile GitHub arasında taşımak için Atoms projenizi GitHub'a bağlayın.

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'ı bağlamanı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, projenizin kodunun ve değişiklik geçmişinin saklandığı GitHub'daki ö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çtiğinizde Plans sayfasına yönlendirilirsiniz.
• GitHub'ı yalnızca çalışma alanı sahibi bağlayabilir veya bağlantısını kesebilir. Bir editörseniz, bu adımı çalışma alanı sahibinden gerçekleştirmesini isteyin.
• 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 projeniz üzerinde çalışan hiçbir Agent yok.

Hesabınızı bağlamak için bir GitHub personal access token'a 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. Görünen açılır menüden Connectors seçeneğini seçin.
4. Kullanılabilir bağlayıcılar listesinde Github seçeneğini bulun ve connect seçeneğine tıklayın.

Ayrıca Settings → Connectors → GitHub bölümünü açıp Connect seçeneğini seçebilirsiniz.

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

GitHub'da Atoms'a yetki verin

Eğer Connected Account zaten kullanmak istediğiniz GitHub hesabını gösteriyorsa, bu hesap zaten yetkilendirilmiştir. Create a private repository 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'un istediği 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ıza yetki verdikten 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ı sağlamalıdır:
   • 1–100 karakter içermeli;
   • yalnızca harfler, sayılar, 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üklemeyi dener.

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ğrulayın:
   • 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'daki ö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.

Eylem	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ındaki en son sürüm kartına geri 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 ayrıca seçili dalın güncellemek istediğiniz dal olduğundan 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 hakim birinden değişiklikleri ayrı bir dalda korumasını isteyin.

Eğer 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 eylem 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.

Bir kez Push Changes seçeneğini seçtiğinizde, değişiklikler onay istenmeden 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 kaldırmak, o GitHub hesabını kullanan tüm Atoms projelerinin bağlantısını keser; bu yüzden 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'u 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 tüm yetkili OAuth uygulamalarının erişimini kaldırır.
6. Github'dan gereken onay adımlarını tamamlayın.
7. Atoms'a geri 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ın erişimini kaldırın.