Pantheon ile çalışma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
bilgi

Apigee, Geliştirici Hizmetleri portalının bulut tabanlı sürümlerini barındırmak için bir web sitesi yönetim hizmeti olan Pantheon'u kullanır. Pantheon, portalınızı güvenli bir ortamda geliştirmenize, test etmenize ve yayınlamanıza olanak tanımak için Drupal ile birlikte çalışacak şekilde tasarlanmıştır. Pantheon'un web sitesi yönetim hizmeti, dünya genelinde barındırma ve geliştirme operasyonu gereksinimleri olan müşterilere sunulur.

Aşağıdaki bölümlerde, portalınızı geliştirmek ve yönetmek için Pantheon'u nasıl kullanacağınız açıklanmaktadır.

Pantheon kontrol paneline erişme

Apigee, portalınızın URL'sini gönderdiğinde Pantheon Kontrol Paneli'nin URL'sini de alırsınız: https://dashboard.getpantheon.com/.

Pantheon kontrol paneline ilk kez giriş yaptığınızda, aşağıda gösterilen Siteler sayfasına yönlendirilirsiniz:

Kontrol panelinden sitenize erişebilir, hesabınızı yapılandırabilir ve diğer işlemleri gerçekleştirebilirsiniz.

Söz konusu sitenin kontrol panelini açmak için sitenizin resmini seçin (örneğin Apigeedocs):

Ortamlarınızı yönetme

Pantheon kontrol panelinde, sayfanın üst kısmında listelenen üç ortam bulunur: Geliştirme, Test ve Canlı. Bunların her biri aşağıdaki tabloda açıklanmıştır.

Ortam

Açıklama

Yeni Geliştirilenler

Dev ortamı, Git deponuza bağlı. Git'e aktardığınız tüm değişiklikler Dev ortamında hemen görünür.

Bu sitenin URL'si aşağıdaki biçimdedir; burada org_name kuruluşunuzun adıdır:

http://dev-{org_name}.devportal.apigee.io/

Test etme

Test ortamı, en son kodunuzu Canlı ortamındaki verilerin kopyasıyla test etmek içindir. Bu ortamda, kod değişikliklerini Canlı ortama aktarmadan önce test edersiniz.

Bu sitenin URL'si aşağıdaki biçimdedir; burada org_name kuruluşunuzun adıdır:

http://test-{org_name}.devportal.apigee.io/

Yayında

Canlı ortam, müşterilerinizin erişebileceği üretim ortamınızdır.

Bu sitenin URL'si aşağıdaki biçimdedir; burada org_name kuruluşunuzun adıdır:

http://live-{org_name}.devportal.apigee.io/

Portal içeriğinizi geliştirme

Aşağıdaki bölümlerde, portal içeriğinizi nasıl geliştireceğiniz açıklanmaktadır.

Ayrıca portalınızı özelleştirmeyle ilgili daha fazla ayrıntı için aşağıdaki bölümleri inceleyin.

Yapmak istediğiniz işlemler

Yapabilecekleriniz

Daha Fazla Bilgi

Sitenin görünümünü ve tarzını değiştirme

Temel - Logo ve site renklerini değiştirme gibi değişiklikler yapmak için portal sitesindeki Görünüm menü girişini kullanın.

Görünümü özelleştirme konusuna bakın:

Gelişmiş: Sitenin görünüm ve tarzını tamamen değiştirmek için Apigee Uyumlu temasını genişletin.

Temayı özelleştirme konusuna bakın.

Site işlevselliğinin davranışını değiştirin

Temel - Sitenin davranış şeklini değiştirmek/yapılandırmak için portaldaki yönetici ayarlarını kullanın.

Buradan başlayan Apigee belgelerine göz atın

Gelişmiş: Sitenin davranışını değiştirmek için özel bir modül oluşturun.

Drupal dokümanlarında Özel modüller oluşturma bölümüne bakın

Git deposuna genel bakış

Drupal kodunuzun Git deposu, portal kodunuzun tümünü içerir ve aşağıdaki yapı kullanılarak düzenlenmiştir.

Not: Yalnızca /sites/all dizinindeki içeriği değiştirin. /sites/all dizininin dışındaki içeriği değiştirirseniz yeni sürümlere geçerken sorun yaşarsınız ve Git'teki değişiklikleri kontrol ederken birleştirme çakışmalarıyla karşılaşabilirsiniz.

Git kod deposundaki klasör

Açıklama

/profiles/apigee

Apigee, aşağıdakiler de dahil olmak üzere modüller ve temalar üzerinde çalıştı:

  • /profiles/apigee/modules/contrib: Apigee tarafından yönetilen Drupal katkı modülleri
  • /profiles/apigee/themes/contrib: Apigee tarafından yönetilen Drupal katkı temaları
  • /profiles/apigee/modules/custom: Apigee tarafından oluşturulan özel modüller
  • /profiles/apigee/themes/custom: Apigee tarafından oluşturulan özel temalar

Not: /profiles/apigee dizinindeki içeriği değiştirmeyin. Aksi takdirde, yeni sürümlere geçiş yaparken sorun yaşarsınız ve Git'teki değişiklikleri kontrol ederken birleştirme çakışmaları yaşayabilirsiniz. Drupal en iyi uygulamaları için Never hack core (Çekirdeği asla hackleme) konusuna bakın.

/sites/all

Özel Drupal modülleriniz ve temalarınız. Bu klasördeki içerikleri yönetme hakkında bilgi edinmek için Özel modül ve temalar ekleme ve Drupal profil modüllerini ve temalarını geçersiz kılma sayfalarına göz atın.

Not: Yalnızca /sites/all dizinindeki içeriği değiştirin.

Kodunuza erişme

Git'te kod deponuza erişmek için aşağıdaki bölümlerde açıklanan görevleri gerçekleştirmeniz gerekir:

Ayrıca bkz. Drupal 7 geliştirici portalı kaynak koduna nasıl erişebilirim?

Sunucunuza SSH erişimini etkinleştirme

Drupal kodunuzu yönetmek üzere Git'i kullanabilmeniz için önce SSH'yi Pantheon'a bir SSH anahtarı yükleyerek sunucunuza erişecek şekilde etkinleştirmeniz gerekir.

Sunucunuza SSH erişimini etkinleştirmek için:

  1. https://dashboard.getpantheon.com/ adresinden Pantheon'a giriş yapın.
  2. Kontrol panelinde Hesap'ı seçin.
  3. Soldaki menüden SSH Anahtarları'nı seçin.
  4. Anahtarınızı ekleyip Anahtar ekle'yi seçin.
    Yardıma ihtiyacınız olursa SSH anahtarı oluşturmayı öğrenin bağlantısını seçin.

Git'te kod deponuza erişme

Not: Git deposu yapısına genel bakış için Git deposuna genel bakış sayfasını inceleyin.

Git'te kod deponuza erişmek için:

  1. Pantheon kontrol paneline giriş yapın.
  2. Ana Sites sayfasında, portalınızın simgesini seçin.
  3. Git deposunun URL'si, önceki şekilde gösterildiği gibi Bağlantı Modu'nun sağındaki sayfada görünür.
  4. Git deponuzun URL'sini kopyalayın ve şu komutu kullanarak yerel geliştirme ortamınıza klonlayın:
    > git clone gitURL sitename
    Örneğin:
    > git clone ssh://codeserver.dev.12@codeserver.dev.12.drush.in:2222/~/repository.git devportal.git dev

Git kod deposuna aktardığınız tüm kod değişiklikleri, portalınızın Dev ortamında hemen görünür.

Portal ortamlarınıza kod dağıtma

Portal ortamlarınıza göre kodlama yapmak için:

  1. Kod güncellemelerinizi Git'e aktarın ve bu işlem Dev ortamını hemen günceller.
  2. Pantheon'a giriş yapın ve sitenizi seçin.
  3. Yeni geliştirilenler ortamını seçin.
  4. Kaydetme Günlüğünde kod değişikliğinizle ilgili bir mesaj görmek için soldaki menüden </>Kod'u seçin:
  5. Sayfanın üst kısmındaki Test ortamını seçin.
    1. Geliştirici'yi henüz Test'e yüklemediyseniz bunu şimdi yüklemeniz istenir.
    2. Halihazırda bir Test ortamınız varsa Geliştirici'den dağıtıma hazır bir kayıt olduğunu belirten bir mesaj gösterilir:
  6. Bir siteyi Canlı ortama zaten aktardıysanız isteğe bağlı olarak üçüncü onay kutusunu işaretleyerek canlı veritabanını ve geliştiriciler tarafından yüklenen dosyaları Canlı'dan Test'e kopyalayabilirsiniz. Bu, kod değişikliklerinizi Canlı'da bulunan en son verilerle karşılaştırarak test etmek istediğinizde kullanışlıdır.
  7. Kod Geliştirmeden Dağıt düğmesini seçin.
  8. Test ortamında portalı test edin.
  9. Yeni geliştirilenler ortamında kod düzeltmelerini yapın ve dosyaları test için tekrar Test bölümüne aktarın.
  10. Test tamamlandığında sayfanın üst kısmından Canlı ortamını seçin.
    1. Test'i henüz Live'a yüklemediyseniz şimdi yüklemeniz istenir.
    2. Zaten Canlı bir ortamınız varsa Test'ten alınmaya hazır bir kayıt olduğunu belirten bir mesaj görüntülenir. Bu değişiklikleri, Yeni geliştirilenler'den Test'e dağıttığınız şekilde dağıtın. Testi tamamladığınızda kodu Live ortamına aktarın.

Daha fazla bilgi:

Özel modül ve tema ekleme

Aşağıdaki tabloda listelenen klasörlere kendi özel modüllerinizi ve temalarınızı ekleyerek portalın işlevlerini genişletebilirsiniz.

Not: Yalnızca /sites/all dizinindeki içeriği değiştirin. /sites/all dizininin dışındaki içeriği değiştirirseniz Git'teki değişiklikleri kontrol ederken birleştirme çakışmaları yaşayabilirsiniz.

Modül/Tema Git deposundaki klasör Daha fazla bilgi (Drupal dokümanları)
Özel modüller sites/all/modules/custom Özel modüller oluşturma
Özel temalar sites/all/themes Temayı özelleştirme
Drupal 7'yi Tema Oluşturma

Özel modülü veya temayı Geliştirme ortamına ekledikten sonra, Kodları portal ortamlarınıza dağıtma bölümünde açıklandığı gibi, test için Test'e, ardından üretim için Canlı ortamına dağıtabilirsiniz.

Drupal profil modüllerini ve temalarını geçersiz kılma

Aşağıdaki dizinlerde yer alan modüller ve temalar, Apigee tarafından /profiles/apigee bölgesinde sağlanan ve dağıtılan Drupal profil modüllerini ve temalarını geçersiz kılar. Git kod deponuza genel bakış sayfasına göz atın.

Örneğin, aşağıdaki senaryolarda Apigee Drupal dağıtımındaki bir modülü geçersiz kılmak isteyebilirsiniz:

  • Belirli bir modülün farklı bir sürümünü kullanmak istediğinizde.
  • Planlanan bir sonraki Apigee sürümünden önce güvenlik güncellemesi gerçekleştirmek istiyorsunuz.
Modül/Tema Git deposundaki klasör Daha fazla bilgi (Drupal dokümanları)
Drupal'ın Katkıda Bulunduğu modüller

sites/all/modules/contrib

Not: /sites/all/modules altında herhangi bir yerde depolanan modüller, Apigee Drupal dağıtım modüllerini geçersiz kılar.

Katkıda bulunulan modüller

Not: Bu dizinde Drupal'ın katkıda bulunduğu modüller, Apigee tarafından /profiles/apigee/modules bölgesinde sürdürülüp dağıtılan eşdeğer modülleri geçersiz kılar. Apigee tarafından yönetilen Drupal profil modüllerini kullanmak istiyorsanız bu klasöre eklediğiniz kopya modülleri kaldırın.

Drupal'ın Katkılarıyla Hazırlanan temalar sites/all/themes Katkıda bulunulan temalar

Not: Bu dizindeki Drupal'ın katkıda bulunduğu temalar, /profiles/apigee/themes bölgesinde Apigee tarafından saklanan ve dağıtılan eşdeğer modülleri geçersiz kılar. Apigee tarafından yönetilen profil temalarını kullanmak istiyorsanız bu klasöre eklediğiniz yinelenen modülleri kaldırın.

settings.php dosyası hakkında

Drupal settings.php, Apigee Drupal Geliştirici Portalı yukarı akış Git deposuna bağlıdır. sites/default/settings.php dosyasında değişiklik yapmak istiyorsanız dosyayı doğrudan düzenlemeyin. Bunun yerine, sites/default/settings.local.php adlı bir dosya oluşturun ve özel kodunuzu buraya yerleştirin. sites/default/settings.local.php, settings.php dosyasına eklenmiş.

Örneğin, Pantheon tarafından sağlanan talimatları uygulayarak yayındaki bir site için özel alan oluştururken settings.php dosyasını doğrudan değiştirmek yerine gerekli güncellemeleri sites/default/settings.local.php bölümüne ekleyin.

Portalınızın güvenliğini sağlama

Geliştirme, Test ve Canlı ortamlarıyla ilişkili portal sitelerine varsayılan olarak herkes erişebilir. Bu durumda, sitenin URL'sine sahip olan herkes söz konusu siteye erişebilir. Bununla birlikte, söz konusu kullanıcılar bir hesap kaydedemeyebilir veya siteye giriş yapamayabilir. Kullanıcı kaydını kontrol etme hakkında daha fazla bilgi için Kullanıcı hesapları ekleme ve yönetme başlıklı makaleyi inceleyin.

Büyük olasılıkla Dev ve Test sitenizi herkese açık olmayan sitelerden gizlemek ve geliştirmeyi tamamlayana kadar Canlı sitenizi gizlemek istiyorsunuz. Pantheon, bir siteyi yalnızca uygun kimlik bilgilerine sahip kişilerin erişebileceği şekilde kilitlemek için kullanıcı adı/şifre kontrolü eklemenize olanak tanır.

Ortamın sol tarafındaki menüde Güvenlik'i seçerek üç ortamdan birine kilitleme ekleyebilirsiniz. Daha fazla bilgi için Sitenizi Kilitleme başlıklı makaleyi inceleyin.

Siteniz için TLS/SSL'yi etkinleştirmek istiyorsanız Portalda TLS'yi kullanma bölümünü inceleyin.

Portalınıza Apigee güncellemesi uygulama

Apigee, portalın yeni bir sürümünü yayınladığında Pantheon Kontrol Paneli'nde bir mesaj görüntülenir.

Güncellemeyi genellikle Yeni Geliştirilenler ortamına uygular ve ardından kendi kod değişikliklerinizi test ettiğiniz şekilde test edersiniz. Örneğin, Yeni geliştirilenler ortamını Test'e aktarın, canlı verileri Canlı'dan Test'e aktarın ve ardından güncellemeyi test edin.

Bir güncellemeyi uygulamak için:

  1. https://dashboard.getpantheon.com/ adresinden Pantheon'a giriş yapın ve sitenizi seçin.
  2. Yeni geliştirilenler ortamını seçin.
  3. Soldaki </>Kod menü girişini seçin. Varsa Apigee güncellemeleri listelenir.
  4. Güncellemeyi uygulayın:
    1. Kodu aldıktan sonra update.php dosyasını çalıştır onay kutusunu işaretleyin.
    2. Varsa Kodu aldıktan sonra önbellekleri temizle onay kutusunu seçin.
    3. Deploy Code düğmesini seçin.
  5. Güncelleme tamamlandıktan sonra kontrol panelinin solundaki Durum menü öğesini seçin.
  6. Bir ortamın Durum alanında, aşağıda gösterildiği gibi veritabanı güncellemesi ile ilgili bir hata görebilirsiniz:

    Herhangi bir ortamda bu hatayı görürseniz veritabanını manuel olarak güncelleyin:

    1. Portalınıza yönetici veya içerik oluşturma ayrıcalıklarına sahip bir kullanıcı olarak giriş yapın.
    2. Portalın sol üst köşesindeki Ana sayfa simgesi > Güncellemeleri çalıştır'ı seçin.
    3. Veritabanınızı güncellemek için talimatları uygulayın.
  7. Kod değişikliklerini Test ortamına aktarın, ardından yukarıda açıklandığı gibi Live'a (Canlı) aktarın.

Özel özelliklerinizi taşıma

Portala özel kod veya özellikler eklerseniz bunların bakımını nasıl yapacağınıza ve bunları Yeni geliştirilenler'den Test'e, Canlı ortamlara nasıl taşıyacağınıza karar vermeniz gerekir.

Git deposundaki kodlar için Kodları portal ortamlarınıza dağıtma bölümünde açıklanan işlemi kullanarak kodu Dev'den Test'e ve Live'a taşıyabilirsiniz.

Özel yapılandırmalar oluşturduysanız bunları taşımak için aşağıdaki yöntemlerden birini kullanın:

Yöntem Açıklama
Yapılandırmanızı koda aktarın Yaygın olarak kullanılan çoğu yapılandırma, Özellikler modülü kullanılarak koda "dışa aktarılabilir". Örneğin görünümler, paneller, resim önbelleği vb.
hook_update_N() işlevini uygulama Drupal, hook_update_N() işlevini kullanarak veritabanı ve yapılandırma değişikliklerini yönetir.

Özel bir modülünüz varsa şunları yapabilirsiniz:

  • Değişikliklerinizi işlemek için modülünüzün .install dosyasına hook_update_N() işlevleri ekleyin.
  • Bu değişiklikleri kodunuzla birlikte dağıtın.
  • Aşama ve Üretim ortamlarındaki değişiklikleri taşımak için update.php komutunu çalıştırın.

Ayrıca sitenizi nasıl geliştireceğinize, test edeceğinize ve aktaracağınıza dair genel bir bakış sunan Pantheon İş Akışını Kullanma bölümüne bakın. Bu makalede Yapılandırma Yönetimi bölümü bulunmaktadır.

Özel alan yapılandırma

Ortamlarınızı yönetme bölümünde açıklandığı üzere, Apigee'nin varsayılan olarak apigee.io portalı için sağladığı alan adları, müşterilerinize göstermek istemediğiniz bir ad olabilir.

Ücretli portal planları, portal için özel bir alan adı yapılandırabilir (Geliştirici veya ücretsiz hesaplar özel alan oluşturamaz). Özel alan kullanmak için DNS'nizde CNAME oluşturun ve alanınızı edge.apigee.getpantheon.com adresine yönlendirin.

Örneğin, Mytech adlı bir şirketin özel alan adını yapılandırmak için:

  1. Şu DNS ayarını yapılandırın:
    developer.mytech.com. 3600 IN CNAME kenar.Apigee.getpantheon.com
    Bu DNS değişikliğinin tüm istemci cihazları için geçerli olması 48 saati bulabilir.
  2. Bu alanı yalnızca Live ortamı için Pantheon kontrol panelinize eklemek üzere kontrol panelinin sol tarafındaki Alanlar / SSL menü girişini kullanın.
    Çoğu durumda, DNS'yi Yeni Geliştirilenler ve Test için değil, yalnızca Canlı ortamı için yapılandırırsınız. Üretim için Geliştirme veya Test ortamlarını kullanmamalısınız.

Daha fazla bilgi için buradaki Pantheon belgelerini inceleyin.

Portal yöneticileri ekleme

Apigee'den portalınızın hazır olduğuna dair e-posta aldığınızda Apigee, portal yöneticilerinin listesini önceden yapılandırmış olacaktır. Site kontrol panelinin sağ üst tarafındaki Ekip bağlantısını seçerek bu listeyi görebilirsiniz.

Başka yöneticiler eklemek için Yönetici kullanıcılar oluşturma başlıklı makaleyi inceleyin.

Portalınızı yedekleme

Portalınızı yedeklemek için Pantheon kontrol panelindeki Yedeklemeler sekmesini kullanın. İsteğe bağlı veya otomatik yedek oluşturabilirsiniz. Pantheon'da bir yedekleme üç ayrı arşivden oluşur: veritabanı, dosyalar ve kod.

Daha fazla bilgi için Pantheon dokümanlarındaki Yedekleme Aracı bölümüne bakın.

Durum güncellemelerine abone olma

Apigee sürümü ve durum güncellemelerine status.apigee.com adresinden abone olabilirsiniz. Güncellemelere Abone Ol'u tıklayın, istendiğinde e-posta adresi gibi iletişim bilgilerinizi girin ve Abone ol'u tıklayın. E-posta bildirim yönetimi sayfasında Geliştirici Portalı'nın seçili olduğundan emin olun, diğer bildirim ayarlarını gerektiği şekilde açın ve Tercihleri Güncelle'yi tıklayın.

Pantheon durum güncellemelerine ve olay raporlarına (örneğin, kesinti olduğunda) http://status.getpantheon.com adresinden abone olabilirsiniz. Kaydolmak için Güncellemelere Abone Ol'u tıklayın.