WordPress.com üzerinde GitHub dağıtımları kullanma

GitHub Dağıtımları, GitHub depolarınızı doğrudan WordPress.com sitenizle entegre ederek eklentileri, temaları veya site değişikliklerini dağıtmak için sürüm kontrollü, otomatik bir iş akışı sağlar. Bu kılavuz kurulum sürecini ve bağlı dizinlerinizi nasıl yöneteceğinizi anlatır.

Bu özellik, WordPress.com Kurumsal ve Ticaret paketlerine sahip sitelerde mevcuttur. Kurumsal paketiniz varsa bunu etkinleştirdiğinizden emin olun. Ücretsiz veya Kişisel ve Premium paketlerine sahip sitelerde bu özelliğe erişmek için paketinizi yükseltin.

Bu video İngilizce.
Kendi dilinizde altyazıları okumayı tercih ediyorsanız YouTube’un otomatik alt yazı özelliğini kullanabilirsiniz:

Otomatik çeviri altyazıları açmak için:

1. Videoyu oynatın.
2. Videonun sağ alt köşesindeki ⚙️ Ayarlar simgesine tıklayın.
3. Altyazılar/CC’yi seçin.
4. Otomatik çevir’i seçin.
5. Tercih ettiğiniz dili seçin.

Otomatik dublaj (deneysel) ile dinlemek için:

1. ⚙️ Ayarlar simgesine tıklayın.
2. Ses parçasını seçin.
3. Videoyu hangi dilde dinlemek istediğinizi seçin:

ℹ️ Çeviri ve dublajlar Google tarafından otomatik olarak oluşturulur, mükemmel olmayabilir ve otomatik dublaj hâlâ test aşamasındadır, bu nedenle tüm dillerde mevcut olmayabilir.

WordPress.com sitenize bir GitHub deposunu dağıtmadan önce aşağıdaki adımları izleyerek ikisi arasında bağlantı kurmanız gerekir:

1. https://wordpress.com/sites adresindeki Siteler sayfanızı ziyaret edin
2. Site genel bakışı için sitenizin adına tıklayın.
3. Dağıtımlar sekmesine tıklayın.
4. “Depoyu bağla” düğmesine tıklayın. Eğer listelenen dizinleri görürseniz GitHub hesabınızı zaten bağlamış olursunuz. 11. adıma devam edin.
5. “WordPress.com uygulamasını yükle” düğmesine tıklayın.
6. Yeni bir pencere açılacaktır ve henüz açmadıysanız GitHub hesabınıza giriş yapmanız istenecektir. Ardından bu ekranı göreceksiniz:

7. “Geliştiriciler için WordPress.com Yetkilendir” düğmesine tıklayın.
8. Deponuzun bulunduğu GitHub organizasyonunu veya hesabını seçin.
9. Bağlanmak istediğiniz depoyu/depoları seçin:
   • Tüm depolar: Bu seçeneğin seçilmesi, seçilen GitHub hesabına ait tüm güncel ve gelecekteki depolara WordPress.com erişimi sağlayacaktır. Buna salt okunur genel depolar dahildir.
   • Sadece seçili depolar: Bu seçeneğin seçilmesi, WordPress.com adresinin seçilen GitHub hesabında hangi depolara erişebileceğini seçmenizi sağlar. 
10. Bir seçenek belirledikten sonra Yükle düğmesine tıklayın.
11. Yeni pencere kapanacak ve WordPress.com sayfasına geri döneceksiniz. Seçilen depolarınız, ilgili depoyla ilişkili GitHub hesabıyla birlikte listelenmelidir:

12. Bağlanmak istediğiniz deponun yanındaki Seç seçeneğine tıklayın.

Şu aşamada Yetkili GitHub Uygulamaları ve Yüklü GitHub Uygulamalarıaltında Geliştiriciler için WordPress.com adresini ziyaret etmelisiniz.

Bir depo seçtiğinizde dağıtım ayarlarını yapmanız gerekir:

• Dağıtım dalı: Varsayılan olarak deponun varsayılan dalı (genellikle ana) olarak ayarlanır ancak kullanmak istediğiniz dala değiştirilebilir.
• Hedef dizin: Dosyaları dağıtmak istediğiniz sunucu klasörü. Eklentiler için bu wp-content/plugins/my-plugin-nameolacaktır. Temalar için, wp-content/themes/my-theme-name olacaktır. Kısmi bir site dağıtımı için (yani birden fazla eklenti veya tema), /wp-content kullanabilirsiniz. Bir deponun içeriği, belirtilen dizindeki WordPress sitesinin mevcut içeriğiyle birleştirilecektir.
• Otomatik dağıtımlar: WordPress.com adresine dağıtabileceğiniz iki yol vardır:
  • Otomatik: Kod işlendikten sonra WordPress.com sitenizde dağıtılır. Otomatik dağıtımlar prova siteleri için önerilir.
  • Manuel: Dağıtım talebinde bulunduğunuzda kod dağıtılır. Üretim siteleri için manuel dağıtımlar önerilir.
• Dağıtım modu: İki tür dağıtım vardır:
  • Basit: Bu mod, bilgi havuzunun bir bölümündeki tüm dosyaları siteye kopyalayıp hiçbir gönderi işleme koymadan dağıtır.
  • Gelişmiş: Bu modla, Composer bağımlılıklarını kurma, dağıtım öncesi kod testi ve dosya dağıtımını kontrol etme gibi adımları özel olarak tasarlayan bir iş akışı komutu kullanabilirsiniz. Composer veya Node yazılımına ihtiyaç duyan depolar için idealdir. Daha fazla bilgi için aşağıdaki Gelişmiş Dağıtım’a bakın.

Tüm ayarlar yapılandırıldıktan sonra Bağlan düğmesine tıklayın. Depolarınız eklenecek:

İlk dağıtımı otomatik veya manuel olarak tetiklemeniz gerektiğini unutmayın. Daha sonra istediğiniz zaman “Depo bağla” düğmesine tıklayarak başka bir depo bağlayabilirsiniz.

Gelişmiş Dağıtım ile, dağıtımdan önce deponuzdaki dosyaları işlemek için bir iş akışı komut dosyası sağlayabilirsiniz. Bu, ekibinizin kodlama standartlarını karşıladığından emin olmak için kodunuzu kontrol etmek, birim testleri yapmak, dağıtım dosyaları hariç tutmak, bağımlılıklar yüklemek ve çok daha fazlası gibi birçok olasılığa kapı açar. Başlamak için, iş akışı tariflerimize göz atın.

Gelişmiş Dağıtım’ı ayarlamak için:

1. Dağıtımı yapılandırabileceğiniz bir form görünür.
2. Bağlantıyı yönetmek için bilgi havuzunun adına tıklayın.
3. Sağ tarafta, “Dağıtım modunuzu seçin” seçeneğinin altında Gelişmiş‘i seçin.

4. Depo zaten bir iş akışı dosyası içeriyorsa buradan seçebilirsiniz. Sistem, hata olup olmadığını kontrol eder. Herhangi bir hata bulunmazsa 7. adıma geçin.
5. Önceden yapılandırılmış bir iş akışı dosyası eklemek için “Yeni iş akışı oluştur” seçeneğini de seçebilirsiniz. Bu seçeneği belirlediğinizde, wpcom.yml iş akışı dosyası halihazırda deponuzda mevcutsa onun üzerine yazılacaktır.
6. İş akışı dosyasını depoya eklemek için “Benim için iş akışını yükle” düğmesine tıklayın.
7. Bir iş akışı eklenip doğrulandıktan sonra Güncelle‘ye tıklayın. Deponuzda artık gelişmiş dağıtım kullanılacak.

GitHub deponuzu bir siteye bağladıktan sonra, bir sonraki adım aslında kodunuzu dağıtmaktır. Kullanılabilen iki dağıtım yöntemi vardır: Otomatik ve Manuel.

Depolardaki kod değişiklikleri Github’dan canlı siteye otomatik olarak dağıtıldığı için otomatik dağıtımlar canlı üretim siteleri için önerilmez. Bunun yerine, prova sitesine otomatik dağıtım kurmayı ve hazır olduğunuzda üretim ile senkronize etmeyi düşünün.

Manuel dağıtımlar, her bir dağıtımı manuel olarak tetiklemeniz gerekeceğinden, kod değişikliklerinizin ne zaman yayınlanacağı konusunda size daha fazla kontrol sağlar. Prova sitesi kullanmak istemiyorsanız manuel dağıtımları öneririz.

Dağıtımı manuel olarak tetiklemek için:

1. https://wordpress.com/sites adresindeki Siteler sayfanızı ziyaret edin
2. Site genel bakışı için sitenizin adına tıklayın.
3. Dağıtımlar sekmesine tıklayın.
4. Dağıtmak istediğiniz depodaki üç nokta menüsüne (⋮) tıklayın.
5. “Tetikleyici manuel dağıtımı” seçeneğini seçin. “Dağıtım çalıştırması oluşturuldu” diyen ve dağıtım durumunun “Kuyruğa alındı” olarak değişeceği bir bildirim başlığı görmeniz gerekir.
6. Dağıtımın tamamlanmasını bekleyin (durum “Dağıtıldı” olarak değişecek).

7. Üç nokta menüsüne (⋮) tekrar tıklayın ve “Dağıtım çalışmalarını görün” seçeneğini belirleyin. 
8. Dağıtım çalıştırması günlüğü, Yazarı ve dağıtılan depoya eklemeyi görüntüler. Dağıtım çalıştırması gönderisine tıklarsanız daha fazla bilgi görüntüleyebilirsiniz.

Mevcut GitHub depo bağlantılarınızı yönetmek için:

1. https://wordpress.com/sites adresindeki Siteler sayfanızı ziyaret edin
2. Site genel bakışı için sitenizin adına tıklayın.
3. Dağıtımlar sekmesine tıklayın.
4. O zaman bağlantılar listesini görmelisiniz. 

Bağlantı listesi, bir GitHub deposu ile siteniz arasında en az bir bağlantı olup olmadığını gösterir. Liste, her bağlantı için depo adı ve dalı, bir siteye dağıtılan son depoya ekleme, gerçekleştiğinde, kodun yerleştirildiği yerde, dağıtım işleminin süresi ve durumu gibi ilgili bilgileri içerir.

Üç nokta menüsüne (⋮) tıkladıktan sonra ek işlemler mevcuttur:

• Tetikleyici manuel dağıtımı: Yapılandırılmış dalın en son depoya eklemesinde bir dağıtım çalıştırması başlatır.
• Dağıtım çalışmalarını görün: Bağlı depo için dağıtım çalıştırması günlük görünümünü açar.
• Bağlantıyı yapılandırın: Depo için bağlantı görünümünü yönetmeyi açar.
• Deponun bağlantısını kesin: Depo ile site arasındaki bağlantıyı kaldırır.

Dağıtım çalıştırması günlükleri, otomatik olarak veya manuel olarak tetiklensin, her bir dağıtımın ayrıntılı, adım adım kaydını sağlar. Bu günlükler değişiklikleri izlemenize, dağıtım durumunu izlemenize ve ortaya çıkan sorunları gidermenize yardımcı olur. 30 gün içinde son 10 çalışmadan günlüklere eriştiğinizde, her dağıtım sırasında ne olduğunu kolayca gözden geçirebilir ve her şeyin sorunsuz şekilde çalıştığından emin olabilirsiniz.

Bir dağıtımın günlüklerini kontrol etmek için:

1. https://wordpress.com/sites adresindeki Siteler sayfanızı ziyaret edin
2. Site genel bakışı için sitenizin adına tıklayın.
3. Dağıtımlar sekmesine tıklayın.
4. Günlükleri görüntülemek istediğiniz deponun yanındaki üç nokta menüsüne (⋮) tıklayın.
5. “Dağıtım çalışmalarını görün” seçeneğini seçin.
6. Dağıtım çalışmaları listesi görünümü siteye dağıtılan depoya eklemeleri, dağıtım durumunu, tarihi ve süreyi gösterir.
7. Dağıtım hakkında daha fazla bilgi görüntülemek ve genişletmek için çalışma sırasında herhangi bir yere tıklayın.

Kayıtlar, GitHub’dan kod getirmekten hedef dizine yerleştirmeye kadar yürütülen tüm komutların kaydını sağlar. “Daha fazla göster” seçeneğine tıklayarak daha fazla bilgi edinmek için günlük satırları genişletebilirsiniz.

Sitenizden bir GitHub reposunun bağlantısını kestiğinizde, gelecekte yapılacak değişiklikler sitenizi etkilemeyecektir. Varsayılan olarak, dağıtılan dosyalar sitenizde kalır ancak bağlantı kesme işlemi sırasında bunları kaldırma seçeneğiniz vardır.

Bir depoyu kaldırmak için:

1. https://wordpress.com/sites adresindeki Siteler sayfanızı ziyaret edin
2. Site genel bakışı için sitenizin adına tıklayın.
3. Dağıtımlar sekmesine tıklayın.
4. Dizindeki üç nokta menüsüne (⋮) tıklayın.
5. “Deponun bağlantısını kes” seçeneğini seçin.
6. Bir iletişim penceresi görünecektir. İlişkili dosyaları siteden kaldırmak için geçişe tıklayın.
7. İletişim kutusunu kapatmak ve depo bağlantısını kesmek için “Deponun bağlantısını kes“e tıklayın.

Geliştiriciler için WordPress.com kurulu GitHub Uygulamalarınızda ve Yetkili GitHub Uygulamalarınızdagörünmeye devam edecektir. Bunun sebebi WordPress.com’un hâlâ depoya erişime sahip olması ancak bağlantının silinmiş olmasıdır.

Ayrıca WordPress.com’un GitHub hesabınıza erişimini iptal etmeyi seçebilirsiniz. İstediğiniz zaman GitHub’dan Uygulamalar ayarlarınızı ziyaret ederek yapabilirsiniz. 

GitHub hesabınıza yetkili uygulama erişimini iptal etmek için:

1. Yetkili GitHub Uygulamalarınagidin.
2. Geliştiriciler için WordPress.com adresinin yanındaki İptal‘e tıklayın.
3. “Anlıyorum, erişimi iptal et” düğmesine tıklayın.

Yetkili uygulama erişimini iptal etseniz bile, seçilen hesaplarda Geliştiriciler için WordPress.com uygulaması kurulu kalacağından kod yine de dağıtılabilir.

WordPress.com kurulumuna erişimi iptal etmek ve WordPress.com sitenize kod dağıtma özelliğini devre dışı bırakmak için:

1. Yüklü GitHub Uygulamalarına gidin.
2. Geliştiriciler için WordPress.com adresinin yanındaki Yapılandır‘a tıklayın.
3. Tehlikeli bölge alanında, Kaldır‘a tıklayın ve istendiğinde Tamam‘a tıklayın.

WordPress.com’yi yetkili uygulamalar listesinden kaldırmak, depoların silineceği veya çalışmasının duracağı anlamına gelmez ; WordPress.com’un erişimini iptal ettiğinizde depolarınız GitHub’da olmaya devam edecek ancak WordPress.com artık kod dağıtamayacaktır.