Geliştirici Hizmetleri portalı kurulumu

Edge for Private Cloud s. 4.17.05

Yüklemeden önce aşağıdakilerden emin olun:

• Postgres'i, portalı yüklemeden önce yüklemeniz gerekir. Postgres'i Edge'i yükleme işleminin bir parçası olarak veya portal tarafından kullanılmak üzere bağımsız olarak yükleyebilirsiniz.
  • Postgres'i bağımsız olarak yüklerseniz portalla aynı düğümde olabilir.
  • Edge'in bir parçası olarak yüklenen Postgres'e bağlanıyorsanız ve Postgres ana/bekleme modunda yapılandırılmışsa ana Postgres sunucusunun IP adresini belirtin.
• Yükleme işlemini Red Hat'ın desteklenen bir sürümünün 64 bit sürümünde gerçekleştiriyorsanız Enterprise Linux, CentOS veya Oracle. Desteklenen yazılımlar ve desteklenen sürümler başlıklı makalede desteklenen sürümlerin listesini görebilirsiniz.
• Yum yüklendi.

Yüklemeye genel bakış

Edge apigee-setup yardımcı programını bir düğüme yükledikten sonra, portalı düğüme yüklemek için bu yardımcı programı kullanın. apigee-setup yardımcı programı aşağıdaki forma sahiptir:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

apigee-setup yardımcı programına bilgilere göz atın. Yapılandırma dosyasında apigee-setup yardımcı program, kodu komut satırına girmenizi ister.

Tek şart, yapılandırma dosyasının "Apigee" belirtir.

Örneğin, portalı yüklemek için aşağıdaki komutu kullanın:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p dp -f myConfig

Edge Apigee-setup yardımcı programını yükleme bölümüne bakın .

Yapılandırma dosyası oluşturma

Aşağıda, portal kurulumu için örnek bir sessiz yapılandırma dosyası gösterilmektedir. Bu dosyayı, yapılandırmanıza göre gerektiği gibi düzenleyin. setup.sh dosyasını eklemek üzere -f seçeneğini kullanın.

IP1=IPorDNSnameOfNode

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Specify the name of the portal database in Postgres. 
PG_NAME=devportal 

# Specify the Postgres admin credentials. 
# The portal connects to Postgres by using the 'apigee' user. 
# If you changed the Postgres password from the default of 'postgres' 
# then set PG_PWD accordingly. 
# If connecting to a Postgres node installed with Edge, 
# contact the Edge sys admin to get these credentials. 
PG_USER=apigee 
PG_PWD=postgres 

# The IP address of the Postgres server. 
# If it is installed on the same node as the portal, specify that IP. 
# If connecting to a remote Postgres server,specify its IP address. 
PG_HOST=$IP1 

# The Postgres user credentials used by the portal 
# to access the Postgres database, 
# This account is created if it does not already exist. 
DRUPAL_PG_USER=drupaladmin 
DRUPAL_PG_PASS=portalSecret 

# Specify 'postgres' as the database. 
DEFAULT_DB=postgres 

# Specify the Drupal admin account details. 
# DO NOT set DEVPORTAL_ADMIN_USERNAME=admin. 
# The installer creates this user on the portal. 
DEVPORTAL_ADMIN_FIRSTNAME=firstName 
DEVPORTAL_ADMIN_LASTNAME=lastName 
DEVPORTAL_ADMIN_USERNAME=userName 
DEVPORTAL_ADMIN_PWD=pWord 
DEVPORTAL_ADMIN_EMAIL=foo@bar.com 

# Edge connection details. 
# If omitted, you can set them in the portal UI. 
# Specify the Edge organization associated with the portal. 
EDGE_ORG=edgeOrgName 

# Specify the URL of the Edge management API. 
# For a Cloud based installation of Edge, the URL is: 
# https://api.enterprise.apigee.com/v1 
# For a Private Cloud installation, it is in the form: 
# http://<ms_ip_or_DNS>:8080/v1 or 
# https://<ms_ip_or_DNS>:TLSport/v1 
MGMT_URL=https://api.enterprise.apigee.com/v1 

# The org admin credentials for the Edge organization in the form
# of Edge emailAddress:pword. 
# The portal uses this information to connect to Edge. 
DEVADMIN_USER=orgAdmin@myCorp.com 
DEVADMIN_PWD=pWord 

# The PHP port. 
# If omitted, it defaults to 8888. 
PHP_FPM_PORT=8888 

# You must configure the SMTP server used by the portal. 
# The properties SMTPHOST and SMTPPORT are required. 
# The others are optional with a default value as notated below. 
# SMTP hostname. For example, for the Gmail server, use smtp.gmail.com. 
SMTPHOST=smtp.gmail.com 

# Use SSL for SMTP: 'y' or 'n' (default). 
SMTPSSL="n" 

# SMTP port (usually 25). 
# The value can be different based on the selected encryption protocol. 
# For example, for Gmail, the port is 465 when using SSL and 587 for TLS. 
SMTPPORT=25 

# Username used for SMTP authentication, defaults is blank. 
SMTPUSER=your@email.com 

# Password used for SMTP authentication, default is blank. 
SMTPPASSWORD=yourEmailPassword

1. Apigee Edge bağlantınızı test etme

Portal sunucusunda bir komut isteminden aşağıdaki cURL komutunu yürüterek Edge yönetim sunucusuyla bağlantınızı test edin:

> curl -u {EMAIL}:{PASSWORD} http://<ms_ip_or_DNS>:8080/v1/organizations/{ORGNAME}

veya:

> curl -u {EMAIL}:{PASSWORD} https://<ms_ip_or_DNS>:TLSPort/v1/organizations/{ORGNAME}

Burada EMAIL ve PASSWORD, ORGNAME için yöneticinin e-posta adresi ve şifresidir.

Edge yüklemenize özgü ana makine adını ve bağlantı noktası numarasını belirttiğinizden emin olun. Bağlantı noktası 8080, Edge tarafından kullanılan varsayılan bağlantı noktasıdır. Buluttaki bir kuruluşa bağlanıyorsanız istek URL'si: https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}.

Başarılı olursa bu komut, aşağıdakine benzer bir yanıt döndürür:

{
  "createdAt" : 1348689232699,
  "createdBy" : "USERNAME",
  "displayName" : "cg",
  "environments" : [ "test", "prod" ],
  "lastModifiedAt" : 1348689232699,
  "lastModifiedBy" : "foo@bar.com",
  "name" : "cg",
  "properties" : {
    "property" : [ ]
  },
  "type" : "trial"
}

2. PHP'nin 7.0'dan önceki sürümlerini kaldırma

Yükleme komut dosyası, yükleme işlemine başlamadan önce sistemde PHP'nin 7.0 öncesi sürümlerini kontrol eder. PHP'nin 7.0'dan önceki sürümleri varsa aşağıdaki uyarı mesajı görüntülenir:

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.

php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

Aşağıdaki komutu kullanarak PHP paketlerini kaldırın:

yum remove <package-name>

3. Postgres'i yükle

Portal yüklenebilmesi için Postgres yüklü olmalıdır. Aşağıdaki yöntemlerden birini uygulayabilirsiniz yüklemenin bir parçası olarak Postgres'i yükleyebilir veya portalında yer alır.

• Edge'in bir parçası olarak yüklenen Postgres'e bağlanıyorsanız ve Postgres ana/bekleme modunda yapılandırılmışsa ana Postgres sunucusunun IP adresini belirtin.
• Postgres'i bağımsız olarak yüklerseniz platform, portalla aynı düğümde olabilir.

Edge'in yüklenmesinin bir parçası olarak Postgres'in yüklenmesi hakkında bilgi edinmek için Edge bileşenlerini bir düğüme yükleme başlıklı makaleye bakın.

Postgres'i bağımsız olarak yüklemek için:

1. apigee-setup internette olup olmadığını kontrol edin. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme daha fazla.
2. Aşağıda gösterildiği gibi Postgres için bir yapılandırma dosyası oluşturun:
   
   # IP adresine veya DNS'ye çözümlenmelidir ana makine adı - 127.0.0.1 veya localhost'a değil.
   HOSTIP=$(anamakineadı -i)
   
   # Postgres'in kapsülü ve bölgesi. Aşağıdaki varsayılan değerleri kullanın.
   MP_POD=gateway
   BÖLGE=dc-1
   
   # Postgres şifresini ayarlayın. Varsayılan değer "postgres"tir.
   PG_PWD=postgres
3. Komut isteminde, Postgres'i yüklemek için kurulum komut dosyasını çalıştırın:
   > /opt/Apigee/Apigee-setup/bin/setup.sh -p pdb -f configFile
   
   “-p pdb” seçeneği Postgre'i yükleyeceğini belirtir.
   
   Yapılandırma dosyası "Apigee" tarafından erişilebilir veya okunabilir olmalıdır belirtir.

4. Portalı yükleme

Portalı yüklemek için:

1. Edge apigee-setup yardımcı programını düğümün düğümünün kaldırılması gerekir. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme daha fazla.
2. Postgres'i, Postgres bağımsız olarak veya Edge'i yüklüyor.
3. Komut isteminde kurulum komut dosyasını çalıştırın:
   > /opt/Apigee/Apigee-setup/bin/setup.sh -p dp -f configFile
   
   "-p dp" seçeneği, portalın yükleneceğini belirtir.
   
   Yapılandırma dosyası "Apigee" tarafından erişilebilir veya okunabilir olmalıdır belirtir.
4. http://localhost:8079 adresindeki portal ana sayfasına veya portalınıza gelecektir.
5. Yapılandırmada ayarladığınız yönetici kimlik bilgilerini kullanarak portala giriş yapın. dosyası olarak kaydedebilirsiniz.

5. Güncelleme yöneticisi modülünün etkin

Drupal güncellemeleriyle ilgili bildirimler almak için Drupal güncelleme yöneticisi modülünün etkinleştirildiğinden emin olun. Drupal menüsünden Modüller'i seçin ve Güncelleme yöneticisi modülüne gidin. Etkin değilse etkinleştirin.

Bu özelliği etkinleştirdikten sonra Raporlar > Uygun Güncellemeler menü öğesi. Aşağıdaki Drush komutunu da kullanabilirsiniz:

> drush pm-info update

Bu komutu sitenin kök dizininden çalıştırmanız gerekir. Geliştirici Portalı varsayılan olarak /opt/apigee/apigee-drupal/wwwroot konumuna yüklenir. Dolayısıyla, önce dizini /opt/apigee/apigee-drupal/wwwroot olarak değiştirmeniz gerekir komutunu çalıştırın. Portalı, varsayılan dizine yüklemediyseniz yükleme dizinini oluşturur.

Raporlar > Mevcut Güncellemeler > Yapılandırılacak Ayarlar menü öğesi güncellemeler olduğunda size e-posta gönderecek ve güncellemeleri kontrol etme sıklığını güncellemelerine göz atın.

6. Apache Solr arama motorunu yapılandırma (İsteğe bağlı)

Apache Solr arama motoruna bağlanan Drupal modülleri, varsayılan olarak devre dışıdır. portalı yüklemeniz gerekir. Çoğu portal dahili Drupal arama motoru kullandığından gerekir.

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:

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

7. SmartDokümanlar'ı Yükle (İsteğe Bağlı)

SmartDokümanlar, API'lerinizi Geliştirici Hizmetleri portalında API belgeleri tamamen etkileşimlidir. Ancak, SmartDokümanlar'ı portalla kullanmak için öncelikle Edge'de SmartDokümanlar'ı yükleyeceksiniz.

• Portalı bir Edge Cloud kurulumuna bağlıyorsanız SmartDokümanlar zaten yüklenir ve başka yapılandırma gerekmez.
• Portalı Özel Bulut için Edge kurulumuna bağlıyorsanız Edge'e SmartDocs'un yüklü olduğundan emin olmanız gerekir. Edge ve SmartDokümanlar'ı yükleme hakkında daha fazla bilgi için SmartDokümanlar'ı yükleme başlıklı makaleye bakın.

Portalda SmartDokümanlar'ı da etkinleştirmeniz gerekir. SmartDokümanlar hakkında daha fazla bilgi için Doküman oluşturmak için SmartDokümanlar'ı kullanma API'ler.

8. JQuery Update modülünü internet dışı kurulumlar için yapılandırma (İsteğe bağlı)

JQuery Update modülünü internet harici bir kurulumda yükleyip kullanırsanız modülü JQuery'nin yerel sürümünü kullanacak şekilde yapılandırın. Modülü bir CDN kullanacak şekilde yapılandırırsanız bu, internet harici bir kurulumda CDN'ye erişmeye çalışır ve sayfada gecikmelere neden olur. yükleniyor. JQuery Güncelleme modülü hakkında daha fazla bilgi için https://www.drupal.org/project/jquery_update adresine bakın.

JQuery Güncelleme modülünü JQuery'nin yerel sürümünü kullanacak şekilde yapılandırmak için:

1. Portalınıza, yönetici veya içerik oluşturma ayrıcalıklarına sahip bir kullanıcı olarak giriş yapın.
2. Yapılandırma > Geliştirme > JQuery Güncellemesi'ni tıklayın.
3. Soldaki gezinme menüsünden Performans'ı tıklayın.
4. JQuery ve JQuery UI CDN açılır menüsünde Yok'u seçin.
5. Yapılandırmayı kaydet'i tıklayın.

9. Sonra ne olur?

Geliştirici Hizmetleri portalını yükledikten sonraki adımlarınız, ayarlarınızı yapılandırmak ve özelleştirmektir. yardımcı olur. Apigee web sitesindeki belgelerde portalını yapılandırma, yönetme ve yönetme hakkında bilgi edindiniz. http://apigee.com/docs/developer-services/content/what-developer-portal adresindeki belgelere erişebilirsiniz.

Aşağıdaki tabloda yükleme işleminden sonra gerçekleştirdiğiniz ve ve daha fazla bilgi bulabileceğiniz Apigee belgelerinin bağlantılarını içerir:

Görev	Açıklama
tema	Tema; renkler, stil ve diğer bilgiler dahil olmak üzere portalın görünümünü tanımlar çok iyi olur.
görünüm	Ana sayfada ana menü, karşılama mesajı, üstbilgi, altbilgi ve başlık yer alır.
Ekle ve Kullanıcı hesaplarını yönetme	Kayıt işlemi, yeni geliştiricilerin portalında yer alır. Örneğin, yeni geliştiriciler portala hemen erişebilir mi yoksa bir yönetici tarafından doğrulanmaları gerekir mi? Bu süreç, bir portalın Yeni bir hesap oluşturulduğunda yöneticisine bildirim gönderilir.
Yapılandırma e-posta	Portal, belirli etkinliklere yanıt olarak e-postalar gönderir. Örneğin, yeni bir Geliştirici, portala kaydolduğunda ve şifresini kaybettiğinde kaydedilir.
Ekle ve Kullanıcı hesaplarını yönetme	Şartlar ve Geliştiricilerin, izin verilmeden önce kabul etmeleri gereken koşullar sayfası portala erişebilirsiniz.
Ekle ve Kullanıcı hesaplarını yönetme	Portalda rol tabanlı bir yetkilendirme modeli uygulanır. Geliştiricilerin portal tarafından kullanılan izin ve rolleri tanımlamanız gerekir.
Blog ekle ve forum gönderileri	Portalda bloglar ve mesaj dizili forumlar için yerleşik destek bulunur. İzinleri tanımlama blog ve forum yayınlarını görüntülemek, eklemek, düzenlemek ve silmek için gereklidir.
Veritabanı yedeklemeleri yaptığınızdan emin olun	Drupal veritabanını yedeklediğinizden emin olun. Unutmayın ki her farklıysa, verilerinizi en iyi şekilde nasıl yedekleyeceğinizi belirlemek size Not: Yedekleme ve Taşıma modülü, Postgres veritabanlarıyla uyumlu değildir. Yedekleme işlemi nasıl yapılır? başlıklı makaleye de göz atın.
Ana makine adı ayarlama	DNS sunucunuzda bir ana makine adı ayarlamazsanız siteye her zaman Sunucunun IP adresi. Bir ana makine adı kullanmak istiyorsanız temel kurulumda başka bir yapılandırma olmadan düzgün şekilde çalışması gerekir. Yük dengeleyici oluşturursanız veya bazı kullanıcılar için sitenizde yanlış URL'ler alıyorsanız Alternatif olarak, Geliştirici Portalı settings.php dosyasında $base_url öğesini ayarlayabilirsiniz. Bu, varsayılan olarak /opt/apigee/apigee-drupal/wwwroot/sites/default dizininde kaldırmanız gerekir.
Özel geliştirme	Ayrıca, portalınızın özelliklerini temanızın dışındaki özel kodlarla da genişletebilirsiniz. Bunu yapmak için, Drupal'ın modülünde açıklandığı şekilde kendi Drupal modülünüzü oluşturun geliştirme konularını belirleyin ve modülü /sites/all/modules dizin.