Private Cloud için Edge v. 4.17.01
Yüklemeden önce aşağıdakilerden emin olun:
- Portalı yüklemeden önce Postgres'i yükleyin. 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üklemeyi, desteklenen bir Red Hat Enterprise Linux, CentOS veya Oracle sürümünün 64 bit sürümünde gerçekleştiriyorsunuz. Desteklenen yazılımlar ve desteklenen sürümler başlıklı makalede desteklenen sürümlerin listesini görebilirsiniz.
- Yum yüklü olmalıdır.
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, yüklemeyle ilgili bilgileri içeren bir yapılandırma dosyası gönderin. Yapılandırma dosyasında gerekli bilgiler eksikse apigee-setup yardımcı programı, bu bilgileri komut satırına girmenizi ister.
Tek şart, yapılandırma dosyasının "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmasıdır.
Ö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
Daha fazla bilgi için 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. Bu dosyayı dahil etmek için setup.sh dosyasında -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 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}.
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 ö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
CentOS ve RedHat Enterprise Linux (RHEL) için aşağıdaki komutu kullanarak PHP paketlerini kaldırın:
yum remove <package-name>
3. Postgres'i yükleme
Portal, yüklenmeden önce Postgres'in yüklenmiş olmasını gerektirir. Postgres'i Edge'i yükleme kapsamında veya portal tarafından kullanılacak şekilde 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 uygulama, 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:
- Edge apigee-setup yardımcı programını internet veya internet dışı prosedürü kullanarak düğüme yükleyin. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.
- Aşağıda gösterildiği gibi Postgres için bir yapılandırma dosyası oluşturun:
# Postgres'in kapsülü ve bölgesi. Aşağıda gösterilen varsayılan değerleri kullanın.
MP_POD=gateway
REGION=dc-1
# Postgres şifresini ayarlayın. Varsayılan değer "postgres"tir.
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 configFile
"-p pdb" seçeneği, Postgres'in yükleneceğini belirtir.
Yapılandırma dosyası, "Apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmalıdır.
4. Portalı yükleme
Portalı yüklemek için:
- Edge apigee-setup yardımcı programını interneti veya internet dışı prosedürü kullanarak düğüme yükleyin. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.
- Postgres'i bağımsız olarak veya Edge'i yükleme işleminin bir parçası olarak yüklediğinizden emin olun.
- 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.
"apigee" kullanıcısı, yapılandırma dosyasına erişebilmelidir veya dosyayı okuyabilmelidir. - http://localhost:8079 adresindeki portal ana sayfasına veya portalınızın DNS adına gidin.
- Yapılandırma dosyasında ayarladığınız yönetici kimlik bilgilerini kullanarak portala giriş yapın.
5. Güncelleme Yöneticisi modülünün etkinleştirildiğinden 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 Güncelleme yöneticisi modülüne gidin. Etkin değilse etkinleştirin.
Etkinleştirildikten sonra Raporlar > Kullanılabilir 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. Geliştirici Portalı varsayılan olarak /opt/apigee/apigee-drupal adresine yüklenir. Bu nedenle, komutu çalıştırmadan önce dizini /opt/Apigee/Apigee-drupal 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. SmartDokümanlar'ı Yükle (İsteğe Bağlı)
SmartDocs, API'lerinizi Geliştirici Hizmetleri portalında 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ı, Private Cloud kurulumu için bir Edge'e bağlıyorsanız SmartDokümanlar'ın Edge'de yüklendiğinden 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. Sonra ne olur?
Geliştirici Hizmetleri portalını yükledikten sonraki adımlarınız, portalı özel gereksinimlerinize göre yapılandırmak ve özelleştirmektir. Apigee web sitesindeki dokümanlar, portal oluşturma, biçimlendirme ve yönetme ile ilgili tüm bilgileri içerir. http://apigee.com/docs/developer-services/content/what-developer-portal adresinden dokümanlara erişebilirsiniz.
Aşağıdaki tabloda, yükleme işleminden sonra gerçekleştirdiğiniz en yaygın görevlerden bazıları listelenmiştir ve daha fazla bilgi edinebileceğiniz Apigee dokümanlarına bağlantılar verilmiştir:
|
Görev |
Açıklama |
|
Tema; renkler, stil ve diğer görsel yönler dahil olmak üzere portalın görünümünü tanımlar. |
|
|
Ana sayfa; ana menüyü, karşılama mesajını, üstbilgeyi, altbilgeyi ve başlığı içerir. |
|
|
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. |
|
|
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 bu durum geçerlidir. |
|
|
Geliştiricilerin portala erişmesine izin verilmeden önce kabul etmeleri gereken bir Hükümler ve Koşullar sayfası ekleyin. |
|
|
Portal, rol tabanlı bir yetkilendirme modeli uygular. Geliştiricilerin kaydolmasına izin vermeden önce portalın kullandığı izinleri ve rolleri tanımlayın. |
|
|
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 Gerçekleştirme başlıklı makaleyi de inceleyin. |
|
Barındırıcı adı ayarlama |
DNS sunucunuzda bir ana makine adı ayarlamazsanız siteye dilediğiniz zaman sunucunun IP adresi üzerinden erişebilirsiniz. Bir 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. Bir yük dengeleyici oluşturursanız veya sitenizde başka bir nedenle yanlış URL'ler alıyorsanız varsayılan olarak /opt/apigee/apigee-drupal/sites/default dizininde bulunan Dev Portal settings.php dosyasında $base_url değerini ayarlayabilirsiniz. |
| Özel geliştirme | Portalınızın özelliklerini, temanızın dışında özel kodlarla da genişletebilirsiniz. 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. |