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

Portalı yükleme

Private Cloud için Edge v4.19.01

Apigee Developer Services portalını (veya kısaca portalı) yüklemeden önce aşağıdakilerden emin olun:

Postgres'i, portalı yüklemeden önce yüklemeniz gerekir. Postgres'i Edge'in bir parçası olarak yükleyebilir veya portal tarafından kullanılmak üzere Postgres'i 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 Enterprise Linux, CentOS veya Oracle'ın desteklenen bir sürümünün 64 bit sürümünde gerçekleştiriyorsunuz. Desteklenen sürümlerin listesini Desteklenen yazılımlar ve desteklenen sürümler başlıklı makalede bulabilirsiniz.
Yum yüklendi.

Yükleyici yalnızca Apigee Developer Services portalının (veya kısaca portalın) gerektirdiği, Drupal'a katkıda bulunulan modülleri içerir. Katkıda bulunulan diğer modülleri yükleme hakkında bilgi edinmek için Drupal 7'yi genişletme başlıklı makaleyi inceleyin.

Yüklemeye genel bakış

Portalı yüklemek için aşağıdaki adımları uygulayın. Bu adımların her biri sonraki bölümlerde daha ayrıntılı olarak açıklanmıştır.

Bağlantınızı test edin
PHP'nin 7.0 öncesi sürümlerini kaldırma
Postgres'i yükleme
Portalı yükleme
Güncelleme Yöneticisi'nin etkinleştirildiğinden emin olun
(İsteğe bağlı) Apache Solr'u yapılandırma
(İsteğe bağlı) SmartDocs'u yükleme
(İsteğe bağlı) JQuery'yi yapılandırma

SMTPSSL özelliğinin desteği sonlandırıldı

Önceki sürümlerde, portala bağlı SMTP sunucusu tarafından kullanılan protokolü ayarlamak için SMTPSSL özelliğini kullanıyordunuz. Bu özelliğin desteği sonlandırıldı.

Portala bağlı SMTP sunucusu tarafından kullanılan protokolü ayarlamak için artık SMTPSSL özelliği yerine SMTP_PROTOCOL özelliğini kullanırsınız. Geçerli değerler: "standard", "ssl" veya "tls".

Portal 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. Bu dosyayı eklemek için setup.sh ile -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=PORTAL_ADMIN_PASSWORD
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=ORG_ADMIN_PASSWORD

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

# Optionally configure the SMTP server used by the portal.
# If you do, 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

# Set the SMTP protocol as "standard", "ssl", or "tls",
# where "standard" corresponds to HTTP.
# Note that in previous releases, this setting was controlled by the
# SMTPSSL property. That property has been deprecated.
SMTP_PROTOCOL="standard"

# 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=YOUR_EMAIL_PASSWORD

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

Portalı yükleyeceğiniz sunucu ile Edge yönetim sunucusu arasındaki bağlantınızı test etmek için portal sunucusunda aşağıdaki curl komutunu çalıştırın:

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 alanı için yöneticinin e-posta adresi ve şifresidir.

Edge kurulumunuza özel ana makine adını ve bağlantı noktası numarasını belirttiğinizden emin olun. 8080 bağlantı noktası, 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.

İşlem başarılı olursa curl 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 öncesi 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 öncesi sürümleri varsa aşağıdaki uyarı mesajı gösterilir:

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

Sunucunuza PHP'nin yüklenip yüklenmediğinden emin değilseniz aşağıdaki komutu kullanın:

rpm -qa | grep -i php

Portalda PHP 4.18.01-0.0.49 sürümünün kullanıldığını unutmayın. Bu, Private Cloud için Apigee Edge'in sürüm numarasıyla eşleşmek için tasarlanmamıştır.

3. Postgres'i yükleme

Portal, yüklenmeden önce Postgres'in yüklenmiş olmasını gerektirir. Postgres'i Edge'in bir parçası olarak yükleyebilir veya portal tarafından kullanılmak üzere Postgres'i bağımsız olarak yükleyebilirsiniz.

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 portalla aynı düğümde olabilir.

Edge'i yükleme kapsamında Postgres'i yükleme hakkında bilgi edinmek için Bir düğüme Edge bileşenlerini yükleme başlıklı makaleyi inceleyin.

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

İnternet veya internet dışı prosedürü kullanarak düğüme Edge apigee-setup yardımcı programını yükleyin. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.

Aşağıdaki örnekte gösterildiği gibi bir Postgres yapılandırma dosyası oluşturun:

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

# The pod and region of Postgres. Use the default values shown below.
MP_POD=gateway
REGION=dc-1

# Set the Postgres password. The default value is 'postgres'.
PG_PWD=postgres

Postgres'i yüklemek için komut isteminde kurulum komut dosyasını çalıştırın:
```
/opt/apigee/apigee-setup/bin/setup.sh -p pdb -f postgres_config_file
```
-p pdb seçeneği Postgre'nin yükleneceğini belirtir. Yapılandırma dosyasına "apigee" kullanıcısı tarafından erişilebilmelidir veya dosya okunabilir olmalıdır.

4. Portalı yükleme

Portalı yüklemeden önce aşağıda açıklandığı şekilde aşağıdakileri yaptığınızdan emin olun: 3. Postgres'i yükleyin:

Portalın düğümüne Edge apigee-setup yardımcı programını yükleme
Postgres'i bağımsız olarak veya Edge'i yükleme işleminin bir parçası olarak yükleme

Portalı yüklemek için:

Komut isteminde setup komut dosyasını çalıştırın:
```
/opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile
```
Burada:
- configFile, Portal yapılandırma dosyası oluşturma bölümünde açıklandığı gibi portal yapılandırma dosyasıdır.
  Yapılandırma dosyasına "apigee" kullanıcısı tarafından erişilebilmelidir veya dosya okunabilir olmalıdır.
- -p dp, setup komut dosyasına portalı yükleme talimatı verir.

Portal yüklemesinin başarılı olduğunu doğrulamak için:

http://localhost:8079 adresindeki portal ana sayfasına veya portalınızın DNS adına gidin.
Portal yapılandırma dosyasında ayarladığınız yönetici kimlik bilgilerini kullanarak portala giriş yapın.
Portalın mevcut durumunu görebilmeniz için Drupal menüsünde Raporlar > Durum Raporu'nu seçin.
Yönetim sunucusu bağlantısının başarılı olduğundan emin olun. Bu işlem yapılmadıysa:
1. Portalın Bağlantı Yapılandırması sayfasına gidin (örneğin, http://portal_IP:8079/admin/config/devconnect).
2. Bağlantıyı Test Et düğmesini tıklayın. Bağlantı başarılı olursa işlem tamamlanmış demektir. Bağlantı kurulamazsa devam edin.
3. Uç nokta ve kimlik doğrulama ayarlarını kontrol edin:
  - Management API uç noktası URL'si: Protokolün (HTTP veya HTTPS), IP veya DNS adının ve bağlantı noktası numarasının doğru olduğundan emin olun. Örneğin:
```
http://10.10.10.10:8080/v1
```
  - Uç nokta kimliği doğrulanmış kullanıcı: Kuruluş yöneticisinin kullanıcı adı.
  - Kimlik doğrulanmış kullanıcının şifresi: Kuruluş yöneticisinin şifresi.
  Varsayılan değerler, kurulum işlemi sırasında oluşturduğunuz portal yapılandırma dosyanızdaki ayarları yansıtır.
  
  Bu değerler, 1. adım: Apigee Edge bağlantınızı test edin bölümünde kullandığınız ms_IP_or_DNS, email ve password değerleriyle eşleşmelidir. Kullanıcı adı ve şifre ayrıca ilk katılım yapılandırma dosyasındaki USER_NAME ve USER_PWD özelliklerinin değerleriyle veya rolü Kuruluş Yöneticisi olan tüm kullanıcıların kimlik bilgileriyle eşleşmelidir.
4. Yönetim sunucusuna başarıyla bağlandıktan sonra, değişikliklerinizi kaydetmek için sayfanın alt kısmındaki Yapılandırmayı kaydet düğmesini tıklayın.

5. Güncelleme Yöneticisi modülünün etkinleştirildiğinden emin olun

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.

Etkinleştirildikten sonra Raporlar > Mevcut Güncellemeler menü öğesini kullanarak mevcut güncellemeleri görebilirsiniz. Aşağıdaki Drush komutunu da kullanabilirsiniz:

drush pm-info update

Bu komutu sitenin kök dizininden çalıştırmanız gerekir. Portal varsayılan olarak /opt/apigee/apigee-drupal/wwwroot konumuna yüklenir. Bu nedenle, komutu çalıştırmadan önce dizini /opt/apigee/apigee-drupal/wwwroot olarak değiştirmeniz gerekir. Portalı varsayılan dizine yüklemediyseniz yükleme dizininizi değiştirin.

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

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

Portalı yüklediğinizde, Apache Solr arama motoruna bağlanan Drupal modülleri varsayılan olarak devre dışı bırakılır. Çoğu portal, dahili Drupal arama motorunu kullandığından Drupal Solr modüllerine ihtiyaç duymaz.

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

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

Yönetici veya içerik oluşturma ayrıcalıklarına sahip bir kullanıcı olarak portalınıza giriş yapın.
Drupal menüsünde Modüller'i seçin.
Apache Solr Framework modülünü 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.

7. SmartDocs'u yükleme (isteğe bağlı)

SmartDocs, API'lerinizi portalda API belgelerinin tamamen etkileşimli olmasını sağlayacak şekilde belgelemenize olanak tanır. Ancak SmartDocs'u portalla kullanmak için önce Edge'e yüklemeniz gerekir.

Portalı bir Edge Cloud kurulumuna bağlıyorsanız SmartDocs zaten yüklüdür 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 SmartDocs'u yükleme hakkında daha fazla bilgi için SmartDocs'u yükleme başlıklı makaleyi inceleyin.

Ayrıca portalda SmartDocs'u da etkinleştirmeniz gerekir. SmartDocs hakkında daha fazla bilgi için API'leri belgelemek için SmartDocs'u kullanma başlıklı makaleyi inceleyin.

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

JQuery Güncelleme modülünü internete bağlı olmayan bir kurulumda yükleyip kullanıyorsanız modülü, JQuery'nin yerel sürümünü kullanacak şekilde yapılandırmanız gerekir. Modülü internet dışı bir kurulum için CDN kullanacak şekilde yapılandırırsanız CDN'ye erişmeye çalışır ve sayfa yükleme işleminde gecikmelere neden olur. JQuery Güncelleme modülü hakkında daha fazla bilgi için https://www.drupal.org/project/jquery_update adresine bakın.

JQuery Update modülünü, JQuery'nin yerel sürümünü kullanacak şekilde yapılandırmak 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 Yapılandırma > Geliştirme > JQuery Güncellemesi'ni seçin.
Sol gezinme menüsünde Performans'ı tıklayın.
JQuery ve JQuery UI CDN açılır menüsünde Yok'u seçin.
Yapılandırmayı kaydet'i tıklayın.

9. Sonraki adımlar

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

Görev	Açıklama
Temayı özelleştirme	Tema; renkler, stil ve diğer görsel yönler dahil olmak üzere portalın görünümünü tanımlar.
Görünümü özelleştirme	Ana sayfa; ana menüyü, karşılama mesajını, üstbilgeyi, altbilgeyi ve başlığı içerir.
Kullanıcı hesapları ekleme ve yönetme	Kayıt süreci, yeni geliştiricilerin portala nasıl hesap kaydettiğini kontrol eder. Örneğin, yeni geliştiriciler portala hemen erişebilir mi yoksa bir yönetici tarafından doğrulanmaları gerekir mi? 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-postalar gönderir. Örneğin, yeni bir geliştirici portala kaydolduğunda ve bir geliştirici şifresini kaybettiğinde.
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	Portalda rol tabanlı bir yetkilendirme modeli uygulanır. Geliştiricilerin kaydolmasına izin vermeden önce portalın kullandığı 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 oluşturduğunuzdan emin olun	Drupal veritabanını yedeklediğinizden emin olun. Her kurulum farklı olduğundan veritabanını en iyi şekilde nasıl yedekleyeceğinizi belirlemeniz gerektiğini unutmayın. 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.
Barındırıcı adı ayarlama	DNS sunucunuzda ana makine adı ayarlamazsanız siteye dilediğiniz zaman sunucunun IP adresi üzerinden erişebilirsiniz. Ana makine adı kullanmak istiyorsanız sunucu için DNS'yi yapılandırabilirsiniz. Bu, temel bir kurulumda başka bir yapılandırma olmadan düzgün şekilde çalışmalıdır. Yük dengeleyici ayarladıysanız veya sitenizde başka bir nedenle yanlış URL'ler alıyorsanız aşağıdaki adımları uygulayarak Drupal için `$base_url` ayarını yapabilirsiniz: Mevcut değilse `/opt/apigee/data/apigee-drupal-devportal/sites/default/includes` dizinini oluşturun. Bu dizinde `settings.php` adlı bir dosya oluşturun. `settings.php` dosyasına aşağıdakileri ekleyin: /** * Base URL (optional). * * If Drupal is generating incorrect URLs on your site, which could * be in HTML headers (links to CSS and JS files) or visible links * on pages (such as in menus), uncomment the Base URL statement * below (remove the leading hash sign) and fill in the absolute URL * to your Drupal installation. * * You might also want to force users to use a given domain. * See the .htaccess file for more information. * * Examples: * $base_url = 'http://www.example.com'; * $base_url = 'http://www.example.com:8888'; * $base_url = 'http://www.example.com/drupal'; * $base_url = 'https://www.example.com:8888/drupal'; * * It is not allowed to have a trailing slash; Drupal will add it * for you. */ # $base_url = 'http://www.example.com/'; // NO trailing slash! $base_url = ‘http://www.example.com’; Son `$base_url` satırını sitenizin ana makine adı olacak şekilde değiştirin. Dosyayı kaydedin. `/opt/apigee/data/apigee-drupal-devportal/ sites/default/default.settings.php` içindeki diğer tüm ayarları bu dosyaya koyabileceğinizi unutmayın. `$base_url` özelliği hakkında daha fazla bilgi için aşağıdakilere bakın: https://codeburst.io/security-for-drupal-and-related-server-software-3c979b041595 https://www.drupal.org/node/1992030
Özel geliştirme	Ayrıca, portalınızın özelliklerini temanızın dışındaki özel kodlarla genişletmek isteyebilirsiniz. Bunu yapmak için Drupal'ın modül geliştirme konularında açıklandığı şekilde kendi Drupal modülünüzü oluşturun ve modülü `/sites/all/modules` dizinine yerleştirin.