Bu sayfa, Cloud Translation API ile çevrilmiştir.

Geliştirici Hizmetleri portalı kurulumu

Geliştirici Hizmetleri Portalı v. 4.16.05

Geliştirici Kanal Hizmetleri portalını yüklemek için aşağıdaki adımları uygulayın.

Yükleme işlemine devam etmeden önce, Drupal web kök dizininizin tamamını yedekleyin. Varsayılan yükleme konumu /var/www/html'dir, ancak yükleme sırasında bu konumu değiştirmiş olabilirsiniz. Aşağıda açıklanan yükleme adımlarını gerçekleştirdikten sonra, özelleştirmelerinizi yedekten geri yükleyebilirsiniz.

1. Geliştirici Kanal Hizmetleri paketini alma

http://community.apigee.com/content/apigee-customer-support adresine gidin ve Geliştirici Kanal Hizmetleri .tar dosyasını şu iki yöntemden biriyle istemek için Destek Portalınıza giriş yapın'ı seçin:

Edge for Private Cloud indirme dizinine erişim isteyin.
Geliştirici Kanal Hizmetleri .tar dosyasının URL'sini isteyin.

2. Sisteminizin sistem gereksinimlerini karşıladığından emin olun

Portalı yüklemeden önce sunucunuzun aşağıdaki gereksinimleri karşılaması gerekir:

Yükleme işlemini Red Hat Enterprise Linux, CentOS veya Oracle'ın desteklenen bir sürümünün 64 bit sürümünde yaptığınızdan emin olun. Desteklenen sürümlerin listesini burada bulabilirsiniz.
Yum'un yüklü olduğundan emin olun.
(İnternet bağlantısı olmayan bir sunucuya yükleme için) Öncelikle gerekli tüm dosyaları, internet bağlantısı olan bir sunucuya tek bir .tar.gz dosyası olarak indirmeniz gerekir. Ardından, yüklemeyi gerçekleştirmek için internet bağlantısı olmadan bu .tar.gz dosyasını sunucuya kopyalarsınız.
1. İnternet bağlantısı olan bir sunucuya kök veya süper kullanıcı olarak giriş yapın.
2. Yükleme dosyaları için portal_tar gibi bir dizin oluşturun.
3. CD'yi yeni dizine ekleyin ve Geliştirici Kanal Hizmetleri DeveloperServices_x.y.z.tar dosyasını indirin. Burada x.y.z, portal sürüm numarasına karşılık gelir.
4. Şu komutu kullanarak Geliştirici Kanal Hizmetleri .tar dosyasının içeriğini çıkarın:
  > tar -xvf <tar file>
5. CD'yi DeveloperServices-4.x.y.z konumuna getirir.
6. Şu komutu kullanarak portal .tar.gz dosyasını oluşturun:
  > ./non-networked-install.sh
  
  Bu komut, gerekli tüm dosyaları ve bunları tek bir .tar.gz dosyasına indirir. Ardından bu .tar.gz dosyasını, yüklemeyi tamamlamak için internet bağlantısı olmayan sunucunuza kopyalarsınız.
Portal sunucusunda bir komut isteminden aşağıdaki cURL komutunu çalıştırarak Edge yönetim sunucusuyla olan bağlantınızı test edin:
> curl -u {EMAIL}:{ŞİFRE} https://{anamakineadı}:8080/v1/organizations/{ORGNAME}

Burada EMAIL e-posta adresi ve şifresi, PASSWORD için olan EMAIL ve şifredir.

Edge yüklemenize özgü ana makine adını ve bağlantı noktası numarasını belirttiğinizden emin olun. 8080 numaralı bağlantı noktası, Edge tarafından kullanılan varsayılan bağlantı noktasıdır. Cloud'da bir kuruluşa bağlanıyorsanız "
"Modified", "Modified" [4]"
""tane"

3. Geliştirici Kanal Hizmetleri'ni otomatik yükleme komut dosyasını kullanarak yükleyin

Otomatik yükleme komut dosyasını kullanarak portalı yüklemek için aşağıdaki prosedürü uygulayın. Bu prosedür, harici internet bağlantısı olan veya olmayan sunucularda işe yarar.

Sunucuya kök veya süper kullanıcı olarak giriş yapın.
Yükleme dosyaları için portal gibi bir dizin oluşturun.
İnternet bağlantısı olan bir sunucuda:
1. CD'yi yeni portal dizinine ekleyin ve Geliştirici Kanal Hizmetleri DeveloperServices_x.y.z.tar dosyasını indirin. Burada x.y.z, portal sürüm numarasına karşılık gelir.
  
  Dosyayı, Apigee tarafından size gönderilen bağlantıdan bir tarayıcıda veya kopyalayıp aşağıdaki cURL komutuna ekleyerek indirebilirsiniz:
  > curl -kOL <paste link here>
2. Şu komutu kullanarak Geliştirici Kanal Hizmetleri .tar dosyasının içeriğini çıkarın:
  > tar -xvf <tar file>
3. CD'yi DeveloperServices-4.x.y.z konumuna getirir.
4. Şu komutu kullanarak yükleme komut dosyasını çalıştırın:
  > ./networked-install.sh
İnternet bağlantısı olmayan bir sunucuda:
1. 2. bölümde oluşturduğunuz .tar.gz dosyasını kopyalayın. Sisteminizin sistem gereksinimlerini karşıladığından emin olun.
2. Şu komutu kullanarak .tar.gz dosyasının içeriğini çıkarın:
  > tar -xvf <tar dosyası>
3. tar komutuyla oluşturulan dizine ekleyin.
4. install-from-rpm-bundle.sh komut dosyasındaki izinleri ayarlayın:
  > chmod 755 install-from-rpm-bundle.sh
5. install-from-rpm-bundle.sh komut dosyasını şu komutu kullanarak çalıştırın:
  > ./install-from-rpm-bundle.sh
İstemleri yanıtlayın.
Yükleme işlemi tamamlandıktan sonra, bir tarayıcıda sunucu URL'sine gidin. Örneğin:
http://localhost. Yapılandırılmış belirli bir IP'niz veya DNS'niz varsa http://IP_address ya da http://DNS_name adresine de gidebilirsiniz.

Apigee profili Database yapılandırma sayfasına yönlendirilirsiniz.

Not: http://localhost kullanmak zorunda kalmamak için genel olarak bir ana makine adını yapılandırmış ve DNS sunucunuza kaydetmiş olursunuz.
MySQL bağlantısını yapılandırın. MySQL uzak bir makinedeyse Gelişmiş Seçenekler bölümünü genişletin ve söz konusu makinenin bağlantı bilgilerini girin, ardından Kaydet ve devam et'i seçin.
Aşağıdaki bilgileri girip Kaydet'i seçerek Apigee uç noktasıyla bağlantıyı yapılandırın:
Bu değerler hakkında daha fazla bilgi edinmek için Geliştirici Hizmetleri portalı gereksinimleri bölümündeki "Yüklemeye Başlamadan Önce Gerekli Bilgiler" bölümüne bakın.
1. Geliştirici Portalı Kuruluşu
2. Geliştirici Portalı Uç Nokta URL'si
3. Uç Nokta Kimlik Doğrulaması Yapılmış Kullanıcı
4. Kimliği Doğrulanan Kullanıcıların Şifresi
Sorulduğunda, örnek SmartDokümanlar WADL'yi yüklemek için Örnek SmartDokümanlar WADL düğmesini seçin. Bu adımı atlarsanız örnek SmartDokümanlar API'si portalınızda görünmez.
Not: Portalınız Private Cloud için Apigee Edge kurulumuna bağlanıyorsa ve Edge kurulumunun harici internet bağlantısı yoksa SmartDokümanlar'ı kullanmadan önce SmartDokümanlar modülünün ek yapılandırmasını gerçekleştirmeniz gerekir. SmartDokümanlar hakkında daha fazla bilgi için http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis adresine bakın.
SMTP Sunucusu Ayarları'nı yapılandırın. Apigee, portaldan e-posta mesajları göndermek için bir SMTP sunucusu yapılandırmanızı gerektirir.
Daha fazla bilgi için http://apigee.com/docs/developer-services/content/configuring-email adresine bakın.
Aşağıdaki bilgileri girip Kaydet'i seçerek yönetici kullanıcıyı yapılandırın. Drupal'ın varsayılan olarak "yönetici" adında bir yönetici kullanıcı oluşturduğundan kullanıcı adı olarak "yönetici"yi kullanmayın.
Bu adımı atlarsanız aşağıdaki 4. adımda açıklandığı gibi Drush'ı kullanarak bir yönetici oluşturabilirsiniz. Yönetici kullanıcı oluşturun.
1. Geliştiricinin adı ve soyadı
2. Geliştiricinin portalı kullanıcı adı
3. Şifre
4. E-posta adresi
Yükleme işlemi tamamlandıktan sonra settings.php dosyasında izinleri ayarlayın:
> chmod 640 /var/www/html/sites/default/settings.php
http://localhost/ adresindeki portal ana sayfasına veya portalınızın DNS adına gidin.
Yönetici kimlik bilgilerini kullanarak portala giriş yapın.

4. Yönetici kullanıcı oluşturma

Geliştirici Kanal Hizmetleri yüklemeniz için bir yönetici kullanıcı oluşturmak üzere Drush'ı kullanın. Drupal, varsayılan olarak "yönetici" adında bir yönetici kullanıcı oluşturur. Bu nedenle kullanıcı adı olarak "yönetici"yi kullanmayın.

CD'yi drupal_root/sites/varsayılan dizininize ekleyin. Drupal kök dizininin standart konumu şudur: /var/www/html:
> cd <drupal_root>/sites/default
Özel Drupal dosyalarında yazma izinleriniz olduğundan emin olun:
> drush vget file_private_path

Bu komut özel Drupal dosyalarının yolunu döndürür. Örneğin:
file_private_path: 'sites/default/private'

/var/www/html/sites/default/private/. Bu dizinin, sahip ve grup tarafından yazılabileceğinden emin olmak için aşağıdaki komutu kullanın:
chmod -R g+w dirPathAndName
chmod -R o+r dirPathAndName
Yönetici kullanıcı oluşturmak için aşağıdaki komutları girin ve "< >" içindeki komutları kendi değerlerinizle değiştirin:
> drush user-create <username> --mail="<email-address>" --password="<password>"
> drush user-add-role Yönetici <kullanıcıadı>
Yukarıda belirtilen kullanıcı adı ve şifreyi kullanarak geliştirici portalına yönetici olarak giriş yapın.

5. MySQL kök şifresini ayarlayın

MySQL'i portal kurulumunun bir parçası olarak yüklediyseniz kurulum komut dosyası, MySQL kök şifresini varsayılan değere (boş) bırakır.

Kök şifresini ayarlamak için aşağıdaki komutu kullanın:

> mysqladmin -u root password NEWPASSWORD

Daha önce kök şifre belirlediyseniz ve değiştirmek istiyorsanız aşağıdaki komutu kullanın:

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

Şifreyi /var/www/html/sites/default/settings.php dosyasında da güncellemeniz gerekir.

6. Güncelleme yöneticisi modülünün etkin olduğundan emin olun

Drupal güncellemeleriyle ilgili bildirim almak için Drupal Güncelleme yönetici modülünün etkinleştirildiğinden emin olun. Drupal menüsünden Modüller'i seçin ve sayfayı aşağı kaydırarak Yöneticiyi güncelle modülüne gidin. Etkin değilse etkinleştirin.

Etkinleştirildikten sonra Raporlar > Kullanılabilir Güncellemeler menü öğesini kullanarak kullanılabilir güncellemeleri görebilirsiniz. Aşağıdaki Fırça komutunu da kullanabilirsiniz:

> drush pm-info update

Modülü, güncellemeler olduğunda size e-posta gönderecek şekilde yapılandırmak ve güncellemeleri kontrol etme sıklığını ayarlamak için Raporlar > Kullanılabilir Güncellemeler > Ayarlar menü öğesini kullanın.

7. İsteğe bağlı: Üretim sunucusuna dağıtma

Portalı bir üretim sunucusuna dağıtıyorsanız aşağıdakiler de dahil olmak üzere ek güvenlik adımları uygulamanız gerekir:

MySQL kurulumunuzun güvenliğini sağlamak için aşağıdaki komut dosyasını çalıştırın:
> /usr/bin/mysql_secure_installation

Bu komut dosyası, kök şifreyi ayarlar ve kök erişimini yalnızca yerel ana makineyle kısıtlama ve varsayılan olarak oluşturulan test veritabanlarını ve anonim kullanıcıyı kaldırma seçeneği sunar. Üretim sunucuları için bu komut dosyasının çalıştırılması kesinlikle önerilir.
Şirket politikalarınız gerekiyorsa SELinux'u etkinleştirin ve yapılandırın.

8. İsteğe bağlı: Apache Solr arama motorunu yapılandırma

Varsayılan olarak, portalı yüklediğinizde Apache Solr arama motoruna bağlanan Drupal modülleri devre dışı bırakılır. Çoğu portal, dahili Drupal arama motorunu kullanır ve bu nedenle Drupal Solr modüllerini gerektirmez.

Arama motorunuz olarak Solr'u kullanmaya karar verirseniz Solr'u sunucunuza yerel olarak yüklemeniz ve ardından portalda Drupal Solr modüllerini etkinleştirip yapılandırmanız gerekir.

Drupal Solr modüllerini etkinleştirmek için:

Portalınıza yönetici veya içerik oluşturma ayrıcalıklarına sahip bir kullanıcı olarak giriş yapın.
Drupal menüsünde Modüller'i seçin.
Apache Solr Framework ve Apache Solr Search modülünü etkinleştirin.
Değişikliklerinizi kaydedin.
Solr'u https://drupal.org/node/1999280 adresinde açıklandığı şekilde yapılandırın.

9. İsteğe bağlı - HTTPS'yi desteklemek için mod_ssl dosyasını yükleyin

mod_ssl modülü, Apache HTTP Server tarafından web sayfalarını HTTPS üzerinden sunmak için kullanılır. HTTPS kullanmak istiyorsanız mod_ssl dosyasını yüklemek için aşağıdaki komutu kullanın:

> yum install mod_ssl

Portalı SSL kullanacak şekilde yapılandırma hakkında daha fazla bilgi için http://apigee.com/docs/developer-services/content/using-ssl-portal adresine bakın.

10. İsteğe bağlı - SmartDokümanlar'ı yükleme

SmartDokümanlar, API'lerinizi Developer Services portalında API belgelerini tamamen etkileşimli hale getirecek şekilde belgelemenize olanak tanır. Ancak SmartDokümanlar'ı portalla kullanmak için önce SmartDokümanlar'ı Edge'e yüklemeniz gerekir.

Portalı bir Edge Cloud kurulumuna bağlıyorsanız SmartDokümanlar zaten yüklüdür ve başka yapılandırmaya gerek yoktur.
Portalı Private Cloud kurulumu için bir Edge'e bağlıyorsanız SmartDokümanlar'ın Edge'e yüklendiğinden emin olmanız gerekir. Edge ve SmartDokümanlar'ı yükleme hakkında daha fazla bilgi edinmek için SmartDokümanlar'ı Yükleme başlıklı makaleye bakın.

SmartDokümanlar hakkında daha fazla bilgi edinmek için Doküman API'leri için SmartDokümanlar'ı kullanma bölümüne bakın.

11. Sırada ne var?

Geliştirici Hizmetleri portalını yükledikten sonraki adımlarınız, portalınızı kendi gereksinimlerinize göre yapılandırmak ve özelleştirmektir. Apigee web sitesindeki belgelerde portal yapılandırma, stil oluşturma ve yönetme ile ilgili tüm bilgiler yer alır. http://apigee.com/docs/developer-services/content/what-developer-portal adresindeki belgelere erişin.

Aşağıdaki tabloda, kurulumdan sonra gerçekleştirdiğiniz en yaygın görevlerden bazıları ve daha fazla bilgi edinebileceğiniz Apigee belgelerinin bağlantıları yer almaktadır:

Görev	Açıklama
Temayı özelleştirme	Tema; renkler, stil ve diğer görsel özellikler dahil olmak üzere portalın görünümünü tanımlar.
Görünümü özelleştirin	Ana sayfa; ana menüyü, karşılama mesajını, üstbilgiyi, altbilgiyi ve başlığı içerir.
Kullanıcı hesapları ekleme ve yönetme	Kayıt işlemi, yeni geliştiricilerin portala nasıl hesap kaydedeceğini kontrol eder. Örneğin, yeni geliştiriciler portala hemen mi erişebilir yoksa bir yönetici tarafından doğrulanmaları mı gerekiyor? Bu işlem, yeni bir hesap oluşturulduğunda portal yöneticisinin nasıl bilgilendirileceğini de kontrol eder.
E-postayı yapılandırma	Portal, belirli etkinliklere yanıt olarak e-posta gönderir. Örneğin, yeni bir geliştiricinin portala kaydolması ve bir geliştiricinin şifresini kaybetmesi.
Kullanıcı hesapları ekleme ve yönetme	Geliştiricilerin portala erişmesine izin verilmeden önce kabul etmesi gereken bir Hükümler ve Koşullar sayfası ekleyin.
Kullanıcı hesapları ekleme ve yönetme	Portal, rol tabanlı bir yetkilendirme modeli uygular. Geliştiricilerin kaydolmasına izin vermeden önce portal tarafından kullanılan izinleri ve rolleri tanımlayın.
Blog ve forum yayınları ekleme	Portalda bloglar ve mesaj dizili forumlar için yerleşik destek bulunur. Blog ve forum yayınlarını görüntülemek, eklemek, düzenlemek ve silmek için gereken izinleri tanımlayın.
Veritabanı yedekleri yaptığınızdan emin olun	Drupal veritabanını yedeklediğinizden emin olun. Her yükleme farklı olduğundan, veritabanını en iyi şekilde nasıl yedekleyeceğinizi belirlemek size bağlıdır.
Ana makine adı oluşturma	DNS sunucunuzda bir ana makine adı ayarlamazsanız siteye istediğiniz zaman sunucunun IP adresi üzerinden erişebilirsiniz. Ana makine adı kullanmak istiyorsanız sunucu için DNS'yi yapılandırabilirsiniz. Bu yapılandırma, temel kurulumda başka bir yapılandırma olmadan düzgün şekilde çalışacaktır. Yük dengeleyici oluşturduysanız veya başka bir nedenden dolayı sitenizde yanlış URL'ler alıyorsanız $base_url değerini, varsayılan olarak /var/www/html/sites/default dizininde bulunan Geliştirici Portalı settings.php dosyasında ayarlayabilirsiniz.