Akupa ile Çalışma

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

Apigee, Geliştirici Hizmetleri portalının bulut tabanlı sürümlerini barındırmak için web sitesi yönetim hizmeti olan Acquia'yı kullanır. Acquia, 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.

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

Acquia Cloud arayüzüne erişme

Acquia Cloud hesabınız oluşturulduktan sonra https://cloud.acquia.com/ adresindeki Acquia Cloud arayüzü üzerinden portalınıza erişebilirsiniz.

İlk kez giriş yaptığınızda aşağıdaki resimde gösterildiği gibi Uygulamalar sayfası görüntülenir.

Uygulamalar sayfasında, erişiminiz olan ve Acquia Cloud'da barındırılan tüm uygulamalar gösterilir. Uygulama, Acquia Cloud'da yönettiğiniz yazılım öğesidir (ör. Drupal tabanlı portal siteniz).

Aşağıdaki bölümlerde, portal içeriğinizi yönetmek için Acquia Cloud arayüzünün nasıl kullanılacağı açıklanmaktadır.

Acquia Cloud arayüzü hakkında daha fazla bilgi için Acquia Cloud belgelerindeki Acquia Cloud arayüzünde oturum açma ve Acquia Cloud ile uygulamaları yönetme başlıklı makaleleri inceleyin.

Ortamlarınızı yönetme

Acquia Cloud arayüzüne erişin ve Uygulamalar sayfasında, kontrol paneline erişmek için portal sitenizle ilişkili Yönet'i tıklayın.

Aşağıdaki tabloda belirtildiği gibi, iş akışınızı yönetmek için portalınızı geliştirmek, test etmek ve yayınlamak üzere üç ortam sağlanır. Portalınız her ortama dağıtılır ancak benzersiz bir kod dalı veya etiketi, veritabanı vb. ile farklı bir durumda olabilir. Portal ortamlarınıza kod dağıtma başlıklı makaleyi inceleyin.

Ortam Açıklama Varsayılan URL
Dev Yeni özellikler geliştirin ve portalınızı özelleştirin. http://{application-name}xxxxxx.devcloud.acquia-sites.com/

Burada application-name, uygulamanızın adı, xxxxxx ise geliştirme ve aşamayı ayırt etmek için kullanılan benzersiz bir karakter dizesidir.
Aşama En son kodu üretim ortamına göndermeden önce test edin. http://{application-name}yyyyyy.devcloud.acquia-sites.com/

Burada application-name, uygulamanızın adı, yyyyyy ise geliştirme ve aşamayı ayırt etmek için kullanılan benzersiz bir karakter dizesidir.
Üretim Portalınızı üretime (canlı) yayınlayın. http://{application-name}.devcloud.acquia-sites.com/

Burada application-name, uygulamanızın adıdır.

Not: Özel alan yapılandırması konusuna da göz atın.

Daha fazla bilgi için Acquia Cloud belgelerindeki Ortamlarla çalışma bölümüne bakın.

Portalınızı geliştirme

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

Ayrıca, portalınızı özelleştirme hakkında daha fazla bilgi için aşağıdaki bölümlere göz atın.

Bunu yapmak istiyorsanız...

Şunları yapabilirsiniz

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 bölümünü inceleyin.

İleri seviye: Sitenin görünümünde ve tarzında değişiklik yapmak için Apigee duyarlı temasını genişletin.

Temayı özelleştirme bölümüne bakın.

Site işlevinin davranışını değiştirme

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

Buradaki Apigee belgelerine bakı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 başlıklı makaleyi inceleyin.

Git deposuna genel bakış

Drupal kodunuzun Git deposu, portal kodunuzun tamamını içerir ve aşağıdaki yapı kullanılarak düzenlenir.

Not: Yalnızca /sites/all dizinindeki içeriklerde değişiklik yapın. /sites/all dizininin dışındaki içerikleri değiştirirseniz yeni sürümlere yükseltme yaparken sorun yaşarsınız ve Git'te değişiklikleri kontrol ederken birleştirme çakışmaları yaşayabilirsiniz.

Git deposundaki klasör

Açıklama
/profiles/apigee

Apigee tarafından yönetilen modüller ve temalar (ör.

  • /profiles/apigee/modules/contrib: Apigee tarafından yönetilen Drupal contrib modülleri
  • /profiles/apigee/themes/contrib: Apigee tarafından yönetilen Drupal contrib 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 yükseltme yaparken sorun yaşarsınız ve Git'te değişiklikleri kontrol ederken birleştirme çakışmaları yaşayabilirsiniz. Drupal en iyi uygulamaları için Core'u asla hacklemeyin başlıklı makaleyi inceleyin.
/sites/all

Özel Drupal modülleriniz ve temalarınız. Bu klasördeki içeriği yönetme hakkında bilgi edinmek için Özel modüller ve temalar ekleme ve Drupal profil modülleri ile temalarını geçersiz kılma başlıklı makaleleri inceleyin.

Not: Yalnızca /sites/all dizinindeki içeriklerde değişiklik yapın.

Kodunuza erişme

Git'teki kod deponuza erişmek için aşağıdaki bölümlerde açıklanan işlemleri yapmanız gerekir:

Ayrıca Drupal 7 geliştirici portalı kaynak koduna nasıl erişebilirim? başlıklı makaleyi inceleyin.

Sunucunuza SSH erişimini etkinleştirme

Drupal kodunuzu yönetmek için Git'i kullanabilmenizden önce sunucunuza erişmek üzere SSH'yi etkinleştirmeniz gerekir. Daha fazla bilgi için Acquia Cloud belgelerindeki SSH erişimini etkinleştirme başlıklı makaleyi inceleyin.

SSH erişimini etkinleştirmek için:

  1. https://accounts.acquia.com adresinden Acquia Hesapları arayüzüne giriş yapın.
  2. Kimlik bilgileri'ni tıklayın.
  3. İstenirse kimliğinizi doğrulamak için şifrenizi tekrar girin.
  4. SSH anahtarları bölümünde SSH anahtarı ekle'yi tıklayın.
  5. Aşağıdaki bilgileri girin:
    Alan Açıklama
    Takma ad SSH anahtarının takma adı. Takma ad, alfanümerik karakterler ve alt çizgiler içerebilir.
    Ortak anahtar Ortak anahtar.

    SSH ortak anahtarı oluşturma hakkında bilgi edinmek için Acquia Cloud belgelerindeki SSH ortak anahtarı oluşturma başlıklı makaleyi inceleyin.
  6. Anahtar ekle'yi tıklayın.

Git'te kod deponuza erişme

Git deposu, portal sitenizin tüm kodunu içerir. Portalınızı yapılandırmak için yeni kod ekleyebilir veya mevcut kodu özelleştirebilirsiniz. Daha fazla bilgi için Acquia Cloud belgelerinin Kod deponuzu kullanma bölümüne bakın.

Git deposundaki kod deponuza erişmek için:

  1. https://cloud.acquia.com/ adresinden Acquia Cloud arayüzüne giriş yapın.
  2. Portalın ayrıntılarını görüntülemek için Uygulamalar sayfasında Yönet'i tıklayın.
  3. Gezinme çubuğunda Uygulama Bilgileri'ni tıklayın.

  4. Uygulama Bilgileri iletişim kutusundaki kopyalama komutunu kopyalayın.
  5. Aşağıdaki Git komutlarından birini çalıştırarak Git deposunu yerel ortamınıza klonlayın:

    Git deposunu klonlamak ve yeni bir dal oluşturmak için:

    > git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

    Git deposunu master dalından klonlamak için:

    > git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

  6. Uygulama penceresinde gösterilen ilgili komutları kullanarak değişikliklerinizi sahnelemeye, kaydetmeye ve Git deposuna göndermeye hazır olduğunuzda bu adımları tekrarlayın.

    Bir dalı depomuza eklediğinizde Acquia Cloud, ilgili kod dalını çalıştıran ortamı günceller. Bir sonraki bölümde açıklandığı gibi, portal ortamlarınıza kod dağıtabilirsiniz.

Portal ortamlarınıza kod dağıtma

Portal ortamında kod dağıtmak, geçiş yapmak veya kodu geri almak, kodunuzu ortamlar arasında taşımak ya da depo yapısı ve önerilen iş akışı hakkında daha fazla bilgi edinmek için Acquia Cloud dokümanlarında Aquia Cloud'da sitelerle çalışma başlıklı makaleyi inceleyin. Bir ortama yeni kod dağıtırken gerekli veritabanı güncellemelerini yapmak için update.php'yi çalıştırmanız gerekir.

Özel modüller ve temalar ekleme

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

Not: Yalnızca /sites/all dizinindeki içeriklerde değişiklik yapın. /sites/all dizininin dışındaki içerikleri değiştirirseniz Git'te 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'de tema oluşturma

Özel modülü veya temayı Dev ortamına ekledikten sonra, Portal ortamlarınıza kod dağıtma bölümünde açıklandığı gibi, test için Test ortamına, ardından üretim için Canlı ortamına dağıtabilirsiniz.

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

Aşağıdaki dizinlerdeki modüller ve temalar, /profiles/apigee'te Apigee tarafından yönetilen ve dağıtılan Drupal profil modülleri ile temalarını geçersiz kılar. Git deponuza genel bakış başlıklı makaleyi inceleyin.

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

  • Belirli bir modülün farklı bir sürümünü kullanmak istiyorsanız.
  • Bir sonraki planlanmış Apigee sürümünden önce bir güvenlik güncellemesi uygulamak istiyorsunuz.
Modül/Tema Git deposundaki klasör Daha fazla bilgi (Drupal dokümanları)
Drupal Katkıda Bulunan modülleri sites/all/modules/contrib

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

 Katkıda bulunulan modüller

Not: Bu dizindeki Drupal katkılı modülleri, /profiles/apigee/modules'de Apigee tarafından yönetilen ve 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 Katkıda Bulunan Temalar sites/all/themes Katkıda bulunulan temalar

Not: Bu dizindeki Drupal katkılı temalar, /profiles/apigee/themes'de Apigee tarafından yönetilen 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 kopya modülleri kaldırın.

SSL'yi Etkinleştirme

HTTPS kullanarak sitenize güvenli erişim sağlamak için SSL'yi etkinleştirmeniz gerekir.

SSL'yi etkinleştirmek için:

  1. Sertifika yetkilisinden (CA) veya SSL sertifikası tedarikçisinden SSL sertifikası alın. SSL'yi etkinleştirme başlıklı makaleyi inceleyin.
  2. SSL sertifikasını Acquia Cloud arayüzündeki SSL sayfasına yükleyin. SSL sertifikalarını yönetme başlıklı makaleyi inceleyin.

Üretim ortamınızın güvenliğini sağlama

Bir uygulamayı ilk kez oluşturduğunuzda üretim ortamını özgürce yönetebilir ve geliştirme ile hazırlık ortamlarındaki değişiklikleri dağıtabilirsiniz. İçeriğinizi yayınladıktan sonra, içerikte yetkisiz veya yanlışlıkla güncelleme yapılmasını önlemek için üretim ortamını kilitlemek isteyebilirsiniz. Daha fazla bilgi için Acquia Cloud belgelerinin Yayındaki uygulamanızı korumak için üretim modunu kullanma bölümüne bakın.

Üretim ortamınızın güvenliğini sağlamak için:

  1. https://cloud.acquia.com/ adresinden Acquia Cloud arayüzüne giriş yapın.
  2. Portal sitenizin ayrıntılarını görüntülemek için Uygulamalar sayfasında Yönet'i tıklayın.
  3. Üretim ortamı ayrıntılarını görüntülemek için Üretim'i tıklayın.
  4. Gezinme çubuğunda Üretim Modu'nu tıklayın.
  5. Üretim modunu etkinleştirmek için Etkinleştir'i tıklayın.

Modül ve tema güncellemelerini portala uygulama

Apigee, portalınızdaki modülleri ve temaları düzenli olarak otomatik olarak en son sürüme günceller. Güncellemeler yalnızca Dev ortamında yapılır ve diğer portal ortamlarına taşınmaları gerektiğini belirtmek için etiketlenir.

Siteniz Apigee Acquia faturalandırma kuruluşunun bir parçası değilse (örneğin, başka bir barındırma sağlayıcısından kendi kuruluşunuza taşınan yeni bir site) otomatik Devportal güncelleme göndermelerini almak için Apigee'nin Git deponuza erişmesine izin vermeniz gerekir. Daha fazla bilgi için Apigee Destek Ekibi ile iletişime geçin.

Özel modül veya tema eklediyseniz bunları manuel olarak güncellemeniz gerekir.

Aşağıdaki tabloda, modül ve tema güncellemelerinin portala uygulanması için gereken adımlar özetlenmiştir.

Modüller/Temalar Açıklama
Apigee Edge modülleri

Apigee, güncellemeleri yalnızca Dev ortamına otomatik olarak uygular.

Güncellemeleri test ettikten sonra Portal ortamlarınıza kod dağıtma bölümünde açıklandığı gibi Dev'den Stage'a ve Prod ortamlarına taşıyın.
Apigee duyarlı teması

Apigee, güncellemeleri yalnızca Dev ortamına otomatik olarak uygular.

Güncellemeleri test ettikten sonra Portal ortamlarınıza kod dağıtma bölümünde açıklandığı gibi Dev'den Stage'a ve Prod ortamlarına taşıyın.
Drupal çekirdeği ve katkıda bulunulan modüller

Apigee, güncellemeleri yalnızca Dev ortamına otomatik olarak uygular.

Güncellemeleri test ettikten sonra Portal ortamlarınıza kod dağıtma bölümünde açıklandığı gibi Dev'den Stage'a ve Prod ortamlarına taşıyın.
Özel modüller ve temalar

Özel modül ve tema ekleme bölümünde açıklandığı gibi portalınıza özel modül ve tema eklediyseniz güncellemeleri manuel olarak yüklemeniz gerekir.

En son sürümü yerel dizininize manuel olarak veya Drush'ı kullanarak indirin. Ardından, güncellemeleri Git deposuna gönderin. Güncellemeleri test ettikten sonra Portal ortamlarınıza kod dağıtma bölümünde açıklandığı gibi Dev'den Stage'a ve Prod ortamlarına taşıyın.

Özel özelliklerinizi taşıma

Portala özel kod veya yapılandırmalar eklerseniz bunları Dev'den Stage'a ve Prod ortamlarına taşımanız ve sürdürmeniz gerekir.

Git deposundaki kod için Portal ortamlarınıza kod dağıtma bölümünde açıklanan süreci kullanarak kodu Dev'den Stage'a ve Prod'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 aktarma Sık kullanılan yapılandırmaların çoğu, Özellikler modülü kullanılarak koda "dışa aktarılabilir". Örneğin, görüntüleme sayısı, 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 modülünüz varsa:

  • 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.
  • Değişiklikleri Stage ve Prod ortamlarına taşımak için update.php'ü çalıştırın.

Özel alan adı yapılandırma

Ortamlarınızı yönetme bölümünde belirtildiği gibi, portal ortamlarının varsayılan alan adlarının tümü acquia-sites.com ile biter. Sitenizin amacını kişiselleştiren ve daha iyi anlatan kendi özel alan adınızı sağlamanız önerilir. Örneğin, popüler bir alternatif:

https://developers.mycompany.com

Özel alan yapılandırmak için:

  1. Alanınızı portal site ortamınıza ekleyin. Acquia Cloud belgelerindeki Alanları yönetme bölümüne bakın.
  2. Alan adınızın DNS kaydı girişini herkese açık IP adresine (acquia-sites.com alanına değil) yönlendirerek özel alanınızı DNS sağlayıcınızla ayarlayın. Acquia Cloud belgelerinde DNS kayıtlarını genel IP adreslerinize yönlendirme bölümüne bakın.

    Not: Alan adının CNAME girişini bir acquia-sites.com alanına ayarlamayin. Bu işlem, portal sitenizde gecikmeye veya kapalı kalma süresine neden olabilir.

Acquia Insight'ı kullanarak portalınızı izleme

Acquia Insight, performansını, güvenliğini ve arama motoru optimizasyonunu izleyerek portal sitenizi optimize etmenizi sağlayan bir araç paketidir. Daha fazla bilgi için Acquia Insight başlıklı makaleyi inceleyin.

Portalınızı yedekleme

Aşağıdaki tablolarda, portal bileşenlerinizi yedeklemeyle ilgili seçenekler özetlenmiştir.

Bileşen Yedekleme ayrıntıları Daha fazla bilgi için Acquia Cloud Dokümanları
Kod
  • Kod, bir sürüm kontrol sistemi tarafından yönetilir ve her commit yaptığınızda etiketlenir.
  • Dilediğiniz zaman belirli bir etiketle senkronize edebilir veya geri dönebilirsiniz.
Veritabanı
  • Günlük yedeklemeler yapılır ve üç gün boyunca saklanır.
  • Otomatik ve isteğe bağlı yedeklemeleri planlayın.
  • Tüm verilerin dahili felaket anlık görüntüleri her saat alınır.
Dosyalar Manuel yedekleme yapın veya cron işi planlayın.
Tam uygulama Drush'ı kullanarak manuel yedekleme yapın.
.
Drupal dosya sistemi Aşağıdaki seçeneklerden birini kullanarak manuel yedekleme yapın:
  • Dosyalarınızı bir FTP istemcisi veya komut satırı araçları (rsync ve scp) kullanarak kopyalayın.
  • Drush'i kullanarak sıkıştırılmış bir arşiv oluşturun.

Not: Yedekleme ve Taşıma modülü Acquia Cloud'da desteklenmez. Daha fazla bilgi için Yedekleme ve Taşıma modülü Acquia Cloud'da desteklenmiyor başlıklı makaleyi inceleyin.

Etkinlik bildirimlerini görüntüleme

Portal sitenizde gerçekleşen önemli işlemleri (ör. ortamlar arasında kod yükleme veya kopyalama, veritabanı güncellemeleri ve yedeklemeler, sunucu değişiklikleri vb.) takip etmek için etkinlik bildirimlerini görüntüleyebilirsiniz. Daha fazla bilgi için Acquia Cloud dokümanlarında Etkinlik bildirimlerini görüntüleme bölümüne bakın.

Bildirim listesini görüntülemek için:

  1. https://cloud.acquia.com/ adresinden Acquia Cloud arayüzüne giriş yapın.
  2. Portal sitenizin ayrıntılarını görüntülemek için Uygulamalar sayfasında Yönet'i tıklayın.
  3. En son bildirimlerinizi görüntülemek için gezinme çubuğunun sağ üst köşesindeki zil simgesini tıklayın.

  4. Etkinlikle ilgili daha fazla bilgi görüntülemek için bildirimin yanındaki oku tıklayı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, istenen iletişim bilgilerinizi (ör. e-posta adresi) girin ve Abone Ol'u tıklayın. E-posta bildirim yönetimi sayfasında Geliştirici Portalı'nın seçildiğinden emin olun, diğer bildirim ayarlarını gerektiği gibi etkinleştirin veya devre dışı bırakın ve Tercihleri Güncelle'yi tıklayın.

Platformda yapılan hizmet kesintileri, acil durum bakımları veya güvenlik güncellemeleri hakkında bildirim almak için Acquia durum güncellemelerine abone olabilirsiniz. Acquia Cloud güncellemelerine abone olmak için:

  1. Acquia Durumu sayfasına gidin.
  2. Güncellemelere abone ol'u tıklayın.
  3. Güncellemeleri almak için kullanmak istediğiniz yöntemi (e-posta, kısa mesaj vb.) seçin.
  4. Bildirimler sayfasında, durum güncellemeleri almak istediğiniz ürünleri seçin. Örneğin, Acquia Cloud Enterprise.
  5. Tercihleri Güncelle'yi tıklayın.