Edge Kurulumuna Genel Bakış

Edge for Private Cloud 4.18.05 sürümü

Tipik bir Edge kurulumu, birden fazla düğüme dağıtılan Edge bileşenlerinden oluşur. Edge'i bir düğüme yükledikten sonra düğüme bir veya daha fazla Edge bileşeni yükleyip yapılandırırsınız.

Yükleme işlemi

Bir düğüme Edge yükleme işlemi çok adımlı bir işlemdir:

1. Düğümde SELinux'u devre dışı bırakın veya serbest moda ayarlayın. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme bölümüne bakın.
2. Cassandra kimlik doğrulamasını etkinleştirmek isteyip istemediğinize karar verin.
3. Postgres için ana bekleme modunda çoğaltma ayarlamak isteyip istemediğinize karar verin.
4. Önerilen topolojiler listesinden Edge yapılandırmanızı seçin. Örneğin, Edge'i test için tek bir düğüme veya üretim için 13 düğüme yükleyebilirsiniz. Daha fazla bilgi için Yükleme Topolojileri bölümüne bakın.
5. Seçtiğiniz topolojideki her düğüme Edge apigee-setup yardımcı programını yükleyin:
   • Edge bootstrap_4.18.05.sh dosyasını /tmp/bootstrap_4.18.05.sh hedefine indirin.
   • Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin.
   • Edge apigee-setup yardımcı programını ve bağımlılıklarını yükleyin.

     Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme bölümüne bakın.

6. Seçtiğiniz topolojiye göre her düğüme bir veya daha fazla Edge bileşeni yüklemek için apigee-setup yardımcı programını kullanın.

   Edge bileşenlerini bir düğüme yükleme başlıklı makaleye bakın.

7. Yönetim Sunucusu düğümünde, Edge kuruluşlarını oluşturmak ve yönetmek için kullandığınız yardımcı programlar olan Apigee-provide'ı yüklemek için Apigee-setup yardımcı programını kullanın.

   Daha fazla bilgi için Kuruluşa ilk katılım başlıklı makaleyi inceleyin.

8. Yükleme tamamlandıktan sonra Edge kullanıcı arayüzü bileşenini yeniden başlatın.

Yüklemeyi kimler gerçekleştirebilir?

Apigee Edge dağıtım dosyaları, bir dizi BGBG ve bağımlılık şeklinde yüklenir. Edge BGBG'lerini yüklemek, kaldırmak ve güncellemek için komutların kök kullanıcı veya tam sudo erişimine sahip bir kullanıcı tarafından çalıştırılması gerekir. Tam sudo erişimi için bu, kullanıcının root ile aynı işlemleri yapmak üzere sudo erişimine sahip olduğu anlamına gelir.

Aşağıdaki komutları veya komut dosyalarını çalıştırmak isteyen kullanıcılar root ya da tam sudo erişimine sahip bir kullanıcı olmalıdır:

• Apigee-service yardımcı programı:
  • Apigee-service komutları: install, uninstall, update.
  • Apigee-all komutları: install, uninstall, update.
• Edge bileşenlerini yüklemek için setup.sh komut dosyası (Gerekli BGBG'leri yüklemek için "apigee-service install" kullanmadıysanız). Ardından, gerekli değilse root veya tam sudo erişimi.)
• Edge bileşenlerini güncellemek için update.sh komut dosyası

Ayrıca Edge yükleyicisi, sisteminizde "Apigee" adında yeni bir kullanıcı oluşturur. Birçok Edge komutu, "Apigee" kullanıcısı olarak çalışmak için sudo'yu çağırır.

Yukarıda gösterilenlerin dışındaki tüm komutları çalıştırmak isteyen kullanıcılar, "Apigee" kullanıcısına tam sudo erişimi olan bir kullanıcı olmalıdır. Bu komutlar şunlardır:

• Aşağıdakiler dahil Apigee-service yardımcı programı komutları:
  • start, stop, restart, configure gibi Apigee-service komutları.
  • start, stop, restart, configure gibi Apigee-all komutları.

"Apigee" kullanıcısına tam sudo erişimi olan bir kullanıcı oluşturma

Bir kullanıcıyı "Apigee" kullanıcısına tam sudo erişimi sahibi olacak şekilde yapılandırmak için "visudo" komutunu kullanarak sudoers dosyasını ekleyerek şunları ekleyin:

installUser        ALL=(apigee)      NOPASSWD: ALL

Burada installUser, Edge ile çalışan kişinin kullanıcı adıdır.

Yapılandırma dosyalarında izinleri ayarlama

Edge komutlarının kullandığı tüm dosyalar veya kaynaklar, "Apigee" kullanıcısı tarafından erişilebilir olmalıdır. Buna, Edge lisans dosyası ve tüm yapılandırma dosyaları da dahildir.

Bir yapılandırma dosyası oluştururken, Edge komutlarının erişebileceğinden emin olmak için dosyanın sahibini "Apigee:Apigee" olarak değiştirebilirsiniz:

1. Dosyayı bir düzenleyicide herhangi bir kullanıcı olarak oluşturun.
2. chown dosyanın sahibini "Apigee:Apigee" olarak değiştirin veya Edge hizmetini çalıştıran kullanıcıyı "Apigee" kullanıcısından değiştirdiyseniz dosyayı Edge hizmetini çalıştıran kullanıcıya chown işlemi yapın.

Edge yükleme görevlerini kök ve kök olmayan kullanıcılar arasında ayırma

Tüm Edge yükleme işlemini kök olarak veya tam sudo erişimine sahip bir kullanıcı tarafından gerçekleştirmek en basit yöntem olsa da bu her zaman mümkün değildir. Bunun yerine, işlemi kök tarafından gerçekleştirilen görevler ile "Apigee" kullanıcısına tam sudo erişimine sahip bir kullanıcı tarafından gerçekleştirilen görevlere ayırabilirsiniz.

1. Kök tarafından gerçekleştirilen görevler:
   1. bootstrap_4.18.05.sh dosyasını indirip çalıştırın:

      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
      sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

      Bu adım, apigee-service yardımcı programını yükler ve "Apigee" kullanıcısını oluşturur.

   2. Bir kullanıcıyı, Apigee" kullanıcısına tam sudo erişimi olan bir kullanıcı oluşturma bölümünde açıklandığı şekilde "Apigee" kullanıcısına tam sudo erişimine sahip olacak şekilde yapılandırın.
   3. apigee-setup yardımcı programını yükleyin:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. Düğüme Edge BGBG'leri yüklemek için apigee-setup yardımcı programını kullanın:

      /opt/apigee/apigee-service/bin/apigee-service compName install

      Düğüme yüklediğiniz Edge BGBG'leri topolojinize bağlıdır. Kullanılabilir bileşenlerin listesi: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. Kök kullanıcı düğüme Edge BGBG'lerini yükledikten sonra, "Apigee" kullanıcısına tam sudo erişimi olan kullanıcı yapılandırma işlemini tamamlar:
   1. Düğümdeki Edge bileşenlerinin yapılandırmasını tamamlamak için setup.sh yardımcı programını kullanın. Komutun biçimi, düğüme yüklediğiniz bileşenlere bağlıdır. Tam liste için Edge bileşenlerini bir düğüme yükleme bölümüne bakın.

      Örneğin, ZooKeeper ve Cassandra'nın kurulumunu tamamlamak için aşağıdaki komutu kullanın:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      Burada configFile, Edge yapılandırma dosyasıdır.

      Hepsi bir arada yükleme işlemi gerçekleştirmek için aşağıdaki komutu kullanın:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

Yükleme yapılandırma dosyalarının konumu

apigee-setup yardımcı programına, Edge kurulumuyla ilgili bilgileri içeren bir yapılandırma dosyası iletmeniz gerekir. Sessiz yüklemelerde tek şart, yapılandırma dosyasının "Apigee" kullanıcısı tarafından erişilebilir ve okunabilmesidir. Örneğin, dosyayı düğümdeki /usr/local/var veya /usr/local/share dizinine yerleştirin ve dosyayı "Apigee:Apigee" olarak chownekleyin.

Edge sistem yöneticisinin şifresi dışında yapılandırma dosyasındaki tüm bilgiler gereklidir. Şifreyi çıkarırsanız apigee-setup yardımcı programı, şifreyi komut satırına girmenizi ister.

Daha fazla bilgi için Edge bileşenlerini bir düğüme yükleme bölümüne bakın.

Yükleme hatasını işleme

Bir Edge bileşeninin kurulumu sırasında hata meydana gelirse sorunu düzeltip yükleyiciyi tekrar çalıştırmayı deneyebilirsiniz. Yükleyici, bir hata algıladığında veya kurulumdan sonra bir bileşeni değiştirmek ya da güncellemek istediğinizde tekrar tekrar çalışacak şekilde tasarlanmıştır.

Yükleme veya yükseltme işleminden sonra, üzerinde çalıştığı her düğümde Edge kullanıcı arayüzü bileşenini yeniden başlattığınızdan emin olun.

İnternet üzerinden veya internet dışından yükleme

Bir düğüme Edge yüklemek için düğümün Apigee deposuna erişebilmesi gerekir:

• Harici internet bağlantısı olan düğümler

  Harici internet bağlantısı olan düğümler, Edge BGBG'leri ve bağımlılıklarını yüklemek için Apigee deposuna erişir.

• Harici internet bağlantısı olmayan düğümler

  Harici internet bağlantısı olmayan düğümler, Apigee deposunun dahili olarak kurduğunuz yansıtılmış bir sürümüne erişebilir. Bu depo, tüm Edge BGBG'lerini içerir ancak dahili ağdaki depolarda bulunan diğer tüm bağımlılıkların bulunduğundan emin olmanız gerekir.

  Dahili Apigee deposunu oluşturmak amacıyla Edge BGBG'lerini ve bağımlılıklarını indirmek için harici internet erişimi olan bir düğüme ihtiyacınız vardır. Dahili depoyu oluşturduktan sonra onu başka bir düğüme taşıyabilir veya yükleme için Edge düğümlerinin erişimine açabilirsiniz.

Edge sürümünüzü korumak için yerel bir Edge deposunu kullanma

Yerel veya yansıtılmış depo kullanmanın nedenlerinden biri, önceki bölümde açıklandığı gibi Edge'i harici internet bağlantısı olmayan düğümlere yüklemektir.

BGBG yükleme bağımlılıklarını çözme

Apigee Edge dağıtım dosyaları, her birinin kendi yükleme bağımlılıkları zincirine sahip olabilen bir BGBG dosyaları grubu olarak yüklenir. Bu bağımlılıkların çoğu, Apigee'nin kontrolü dışındaki üçüncü taraf bileşenler tarafından tanımlanır ve herhangi bir zamanda değiştirilebilir. Bu nedenle dokümanlarda her bağımlılığın açık sürüm numarası listelenmez.

İnternet erişimi olan bir makineye yükleme yapıyorsanız düğüm, gerekli BGBG'leri ve bağımlılıkları indirebilir. Ancak internet erişimi olmayan bir düğümden yükleme yapıyorsanız genellikle gerekli tüm bağımlılıkları içeren dahili bir depo oluşturursunuz. Tüm bağımlılıkların yerel deponuza dahil edilmesini garanti etmenin tek yolu, yükleme yapmaya çalışmak, eksik bağımlılıkları tespit etmek ve bunları kurulum başarılı olana kadar yerel depoya kopyalamaktır.

Yaygın Yum komutları

Linux için Edge yükleme araçları, bileşenleri yüklemek ve güncellemek için Yum'u kullanır. Bir düğümdeki yüklemeyi yönetmek için birkaç Yum komutu kullanmanız gerekebilir.

• Tüm Yum önbelleklerini temizleyin:

  sudo yum clean all

• Bir Edge bileşenini güncellemek için:

  sudo yum update componentName

  Örneğin:

  sudo yum update apigee-setup
  sudo yum update edge-management-server

Dosya Sistemi Yapısı

Edge, /opt/apigee dizinindeki tüm dosyaları yükler.

Bu kılavuzda ve Edge İşlemleri Kılavuzu'nda kök yükleme dizini şu şekilde belirtilmiştir:

/opt/apigee

Yüklemede, Private Cloud için Apigee Edge'i dağıtmak için aşağıdaki dosya sistemi yapısı kullanılır.

Günlük Dosyaları

apigee-setup ve setup.sh komut dosyası için günlük dosyası /tmp/setup-root.log dosyasına yazılır.

Her bileşenin günlük dosyaları /opt/apigee/var/log dizininde bulunur. Her bileşenin kendi alt dizini vardır. Örneğin, Yönetim Sunucusunun günlükleri dizindedir:

/opt/apigee/var/log/edge-management-server

Aşağıdaki tablolarda günlük dosyalarının konumları listelenmiştir:

Bileşen	Konum
Yönetim Sunucusu	/opt/apigee/var/log/edge-management-server
Yönlendirici	/opt/apigee/var/log/edge-router Uç Yönlendirici, Nginx kullanılarak uygulanır. Ek günlükler için bkz: /opt/apigee/var/log/edge-router/nginx /opt/nginx/logs
Mesaj İşleyici	/opt/apigee/var/log/edge-message-processor
Apigee Qpid Sunucusu	/opt/apigee/var/log/edge-qpid-server
Apigee Postgres Sunucusu	/opt/apigee/var/log/edge-postgres-server
Edge kullanıcı arayüzü	/opt/apigee/var/log/edge-ui
ZooKeeper	/opt/apigee/var/log/apigee-zookeeper
OpenLDAP	/opt/apigee/var/log/apigee-openldap
Cassandra	/opt/apigee/var/log/apigee-cassandra
Qpidd	/opt/apigee/var/log/apigee-qpidd
PostgreSQL veritabanı	/opt/apigee/var/log/apigee-postgresql

Veriler

Bileşen	Konum
Yönetim Sunucusu	/opt/apigee/data/edge-management-server
Yönlendirici	/opt/apigee/data/edge-router
Mesaj İşleyici	/opt/apigee/data/edge-message-processor
Apigee Qpid aracısı	/opt/apigee/data/edge-qpid-server
Apigee Postgres aracısı	/opt/apigee/data/edge-postgres-server
ZooKeeper	/opt/apigee/data/apigee-zookeeper
OpenLDAP	/opt/apigee/data/apigee-openldap
Cassandra	/opt/apigee/data/apigee-cassandra/data
Qpidd	/opt/apigee/data/apigee-qpid/data
PostgreSQL veritabanı	/opt/apigee/data/apigee-postgres/pgdata

Yükleme sonrası görevleri

Yükleme tamamlandıktan sonra Edge bileşenlerinde ek işlemler gerçekleştirebilirsiniz.

Edge kullanıcı arayüzü bileşenini yeniden başlatın

Yükleme tamamlandıktan sonra her düğümde Edge kullanıcı arayüzü bileşenini yeniden başlatmanız gerekir:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Edge bileşenlerini yükleme sonrasında yapılandırma

Kurulumdan sonra Edge'i yapılandırmak için .properties dosyaları ve Edge yardımcı programlarının bir kombinasyonunu kullanırsınız. Örneğin, Edge kullanıcı arayüzünde TLS/SSL'yi yapılandırmak için .properties dosyalarını gerekli özellikleri ayarlamak üzere düzenlersiniz. .properties dosyalarında yapılan değişiklikler, etkilenen Edge bileşenini yeniden başlatmanızı gerektirir.

.properties dosyaları, /opt/apigee/customer/application dizininde bulunuyor. Her bileşenin, bu dizinde kendi .properties dosyası vardır. Örneğin, router.properties ve management-server.properties.

Bir bileşen için özellik ayarlamak üzere ilgili .properties dosyasını düzenleyip bileşeni yeniden başlatın:

/opt/apigee/apigee-service/bin/apigee-service component restart

Örneğin:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

Edge'i güncellediğinizde /opt/apigee/customer/application dizinindeki .properties dosyaları okunur. Yani güncelleme, bileşen üzerinde ayarladığınız tüm özellikleri korur.

Edge yapılandırması hakkında daha fazla bilgi için Edge'yi yapılandırma bölümüne bakın.

Edge bileşenlerinde komutları çağırma

Edge, /opt/apigee/apigee-service/bin altında bir Edge yüklemesini yönetmek için kullanabileceğiniz yönetim yardımcı programları yükler. Örneğin, düğümdeki tüm Edge bileşenlerinin durumunu başlatmak, durdurmak, yeniden başlatmak veya belirlemek için apigee-all yardımcı programını kullanabilirsiniz:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Bileşenleri ayrı ayrı denetlemek ve yapılandırmak için apigee-service yardımcı programını kullanın. apigee-service yardımcı programı şu biçimdedir:

/opt/apigee/apigee-service/bin/apigee-service component_name action

Burada component_name, bileşeni tanımlar. Bileşen, apigee-service öğesini yürüttüğünüz düğümde olmalıdır. Yapılandırmanıza bağlı olarak component_name değerleri şunları içerebilir:

• apigee-cassandra (Cassandra)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (PostgreSQL veritabanı)
• apigee-qpidd (Qpidd)
• apigee-sso (Edge TOA)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (Yönetim Sunucusu)
• edge-management-ui (yeni Edge kullanıcı arayüzü)
• edge-message-processor (Mesaj İşleyici)
• edge-postgres-server (Postgres Sunucusu)
• edge-qpid-server (Qpid Sunucusu)
• edge-router (Edge Yönlendirici)
• edge-ui (Klasik kullanıcı arayüzü)

Bu bileşenlere ek olarak, yapılandırmanıza bağlı olarak apigee-provision ve apigee-validate bileşenlerinde apigee-service çağırabilirsiniz.

Örneğin, Uç Yönlendirici'yi yeniden başlatmak için aşağıdaki komutu yürütün:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

/opt/apigee dizinini inceleyerek düğümde yüklü olan bileşenlerin listesini öğrenebilirsiniz. Bu dizin, düğümde yüklü her Edge bileşeni için bir alt dizin içerir. Her alt dizinin başında şunlar bulunur:

• apigee: Edge tarafından kullanılan üçüncü taraf bileşen. Örneğin, apigee-cassandra.
• edge: Apigee'den bir Edge bileşeni. Örneğin, edge-management-server.
• edge-mint: Bir Para Kazanma bileşeni. Örneğin, edge-mint-management-server.

Bileşenlerle ilgili işlemlerin tam listesi bileşenin kendisine bağlıdır ancak tüm bileşenler aşağıdaki işlemleri destekler:

• start, stop, restart
• status, version
• backup, restore
• install, uninstall

Yüklemede sistem kontrolünü etkinleştir

Edge yükleme yapılandırma dosyası şu özelliği destekler:

ENABLE_SYSTEM_CHECK=y

Bu özelliği "y" olarak ayarlarsanız yükleyici, sistemin yüklenen bileşenin CPU ve bellek gereksinimlerini karşılayıp karşılamadığını kontrol eder. Kontrolü devre dışı bırakmak için varsayılan değer "n"dir.