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.
- Git deposuna genel bakış
- Kodunuza erişme
- Portal ortamlarınıza kod dağıtma
- Özel modül ve temalar ekleme
- Drupal profil modüllerini ve temalarını geçersiz kılma
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ı:
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:
- https://dashboard.getpantheon.com/ adresinden Pantheon'a giriş yapın.
- Kontrol panelinde Hesap'ı seçin.
- Soldaki menüden SSH Anahtarları'nı seçin.
- 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:
- Pantheon kontrol paneline giriş yapın.
- Ana Sites sayfasında, portalınızın simgesini seçin.
- Git deposunun URL'si, önceki şekilde gösterildiği gibi Bağlantı Modu'nun sağındaki sayfada görünür.
- 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:
- Kod güncellemelerinizi Git'e aktarın ve bu işlem Dev ortamını hemen günceller.
- Pantheon'a giriş yapın ve sitenizi seçin.
- Yeni geliştirilenler ortamını seçin.
- Kaydetme Günlüğünde kod değişikliğinizle ilgili bir mesaj görmek için soldaki menüden </>Kod'u seçin:
- Sayfanın üst kısmındaki Test ortamını seçin.
- Geliştirici'yi henüz Test'e yüklemediyseniz bunu şimdi yüklemeniz istenir.
- 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:
- 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.
- Kod Geliştirmeden Dağıt düğmesini seçin.
- Test ortamında portalı test edin.
- Yeni geliştirilenler ortamında kod düzeltmelerini yapın ve dosyaları test için tekrar Test bölümüne aktarın.
- Test tamamlandığında sayfanın üst kısmından Canlı ortamını seçin.
- Test'i henüz Live'a yüklemediyseniz şimdi yüklemeniz istenir.
- 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:
- Pantheon, bu işlemle ilgili görüntüleyebileceğiniz bir Canlı Yayındaki Makaleler seti sağlar. Bunlardan en önemlisi, sitenizi nasıl geliştireceğiniz, test edeceğiniz ve aktaracağınıza genel bir bakış sunan Pantheon İş Akışını Kullanma makalesidir.
Ö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 |
Not: |
Katkıda bulunulan modüller
Not: Bu dizinde Drupal'ın katkıda bulunduğu modüller, Apigee tarafından |
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, |
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:
- https://dashboard.getpantheon.com/ adresinden Pantheon'a giriş yapın ve sitenizi seçin.
- Yeni geliştirilenler ortamını seçin.
- Soldaki </>Kod menü girişini seçin. Varsa Apigee güncellemeleri listelenir.
- Güncellemeyi uygulayın:
-
Kodu aldıktan sonra update.php dosyasını çalıştır onay kutusunu işaretleyin.
-
Varsa Kodu aldıktan sonra önbellekleri temizle onay kutusunu seçin.
-
Deploy Code düğmesini seçin.
-
- Güncelleme tamamlandıktan sonra kontrol panelinin solundaki Durum menü öğesini seçin.
- 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:
- Portalınıza yönetici veya içerik oluşturma ayrıcalıklarına sahip bir kullanıcı olarak giriş yapın.
- Portalın sol üst köşesindeki Ana sayfa simgesi > Güncellemeleri çalıştır'ı seçin.
- Veritabanınızı güncellemek için talimatları uygulayın.
- 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:
|
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:
- Ş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. - 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.