Edge Kurulumuna Genel Bakış

Private Cloud için Edge v. 4.17.01

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

Edge'i bir düğüme yüklemek çok adımlı bir işlemdir:

  • Düğümde SELinux'u devre dışı bırakın veya izin verici moda ayarlayın. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.
  • Cassandra kimlik doğrulamasını etkinleştirmek isteyip istemediğinize karar verin.
  • Postgres için ana bekleme replikası oluşturmak isteyip istemediğinize karar verin.
  • Ö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 Postgres için Ana-Yedek Kopyalama ayarlama başlıklı makaleyi inceleyin.
  • Seçtiğiniz topolojideki her düğümde Edge Apigee-setup yardımcı programını yükleyin:
    • Edge bootstrap_4.17.01.sh dosyasını /tmp/bootstrap_4.17.01.sh adresine 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 başlıklı makaleyi inceleyin.
  • 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.
    Bir düğüme Edge bileşenleri yükleme başlıklı makaleyi inceleyin.
  • Yönetim sunucusu düğümünde, Edge kuruluşları oluşturmak ve yönetmek için kullandığınız apigee-provision yardımcı programını yüklemek üzere apigee-setup yardımcı programını kullanın.
    Daha fazla bilgi için Kuruluşları ilk katılıma dahil etme başlıklı makaleyi inceleyin.

Yüklemeyi gerçekleştirebilecek kullanıcılar

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

Aşağıdaki komutları veya komut dosyalarını çalıştırmak isteyen kullanıcıların root olması veya tam sudo erişimine sahip olması gerekir:

  • 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 daha önce "qwiklabs-service install" dosyasını kullanmadıysanız) Ardından, gerekli değilse kök veya tam sudo erişimi.)
  • Edge bileşenlerini güncellemek için update.sh komut dosyası

Ayrıca Edge yükleyici, sisteminizde "apigee" adlı yeni bir kullanıcı oluşturur. Birçok Edge komutu "Apigee" kullanıcısı olarak çalıştırmak için sudo komutunu çağırır.

Yukarıda gösterilenlerden başka tüm komutları çalıştırmak isteyen kullanıcıların "apigee" kullanıcısına tam sudo erişimi olan kullanıcılar olması gerekir. Bu komutlar arasında şunlar yer alır:

  • Aşağıdakiler dahil olmak üzere apigee-service yardımcı programı komutları:
    • Başlat, durdur, yeniden başlat, yapılandır gibi apigee-service komutları.
    • Başlat, durdur, yeniden başlat, yapılandır gibi apigee-all komutları.

Bir kullanıcının "Apigee" kullanıcısına tam sudo erişimine sahip olmasını sağlamak için sudoers dosyasını düzenleyerek şunları ekleyin:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

"Apigee" kullanıcısı, Edge komutları tarafından kullanılan tüm dosyalara veya kaynaklara erişebilmelidir. Bu, Edge lisans dosyasını ve tüm yapılandırma dosyalarını içerir.

Bir yapılandırma dosyası oluştururken, Edge komutlarının erişebilmesi için dosyanın sahibini "apigee:apigee" olarak değiştirebilirsiniz:

  1. Dosyayı bir düzenleyicide herhangi bir kullanıcı olarak oluşturun.
  2. 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 dosyanın sahibini Edge hizmetini çalıştıran kullanıcı olarak değiştirin.

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

Edge kurulumuyla ilgili bilgileri içeren Apigee-setup yardımcı programına 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 veya okunabilir olmasıdır. Örneğin, dosyayı düğümdeki /usr/local/var veya /usr/local/share dizinine yerleştirin ve "apigee:apigee" olarak sahiplendirin.

Edge sistem yöneticisinin şifresi dışında yapılandırma dosyasında bulunan tüm bilgiler gereklidir. Şifreyi atlarsanı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 başlıklı makaleyi inceleyin.

Yükleme hatalarını ele alma

Edge bileşeni kurulurken hata oluşursa sorunu düzeltmeyi deneyebilir, daha sonra yükleyiciyi tekrar çalıştırabilirsiniz. Yükleyici, bir hata algıladığı durumlarda veya yükleme sonrasında bir bileşeni değiştirmek ya da güncellemek istediğinizde tekrar tekrar çalıştırılmak üzere tasarlanmıştır.

İnternet veya internet dışı kurulum

Edge'i bir düğüme 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 RPM'lerini 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, dahili olarak oluşturduğunuz Apigee deposunun kopyalanan bir sürümüne erişebilir. Bu depo tüm Edge RPM'lerini içerir ancak diğer tüm bağımlılıklara dahili ağdaki depolardan erişebilmeniz gerekir.

    Not: Apigee, tüm üçüncü taraf bağımlılıkları herkese açık depolarımızda barındırmaz. Bu bağımlılıkları herkese açık depolardan indirip yüklemeniz gerekir.

    Edge RPM'lerini ve bağımlılıklarını indirebilmek için dahili Apigee deposunu oluşturmak üzere harici internet erişimi olan bir düğüme ihtiyacınız vardır. Şirket içi deposu oluşturduktan sonra başka bir düğüme taşıyabilir veya bu düğümü Edge düğümleri tarafından yüklenmeye hazır hale getirebilirsiniz.

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

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

Bununla birlikte, harici internet bağlantısı olan düğümler için bile yerel depo kullanmanın başka bir avantajı da vardır. Edge'i Apigee herkese açık deposundan yüklediğinizde her zaman en güncel Edge RPM'lerini yüklersiniz. Bu nedenle, Edge'in belirli bir sürümü için Edge RPM'lerini indirip depolamak istiyorsanız söz konusu Edge sürümü için yerel bir depo oluşturmanız gerekir. Ardından, Edge'in herhangi bir sürümünü yüklemek için bu yerel deposu kullanabilirsiniz.

Örneğin, ilk olarak bir Edge geliştirme ortamı yüklemek için yerel depoyu kullanacaksınız. Ardından, üretim ortamına geçmeye hazır olduğunuzda Edge'i yerel depodan tekrar yüklersiniz. Yerel depodan yükleyerek geliştirme ve üretim ortamlarınızın eşleştiğini garanti edersiniz.

Yansıtılmış bir depo çok esnektir. Örneğin, en son Edge RPM'lerinden veya Edge'in belirli bir sürümünden yansıtılmış bir depo oluşturabilirsiniz. Depoyu oluşturduktan sonra, farklı Edge sürümlerinden RPM'ler eklemek için de güncelleyebilirsiniz. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.

RPM yükleme bağımlılıkları

Apigee Edge dağıtım dosyaları, her biri kendi yükleme bağımlılık zincirine sahip olabilecek bir RPM dosyası grubu olarak yüklenir. Bu bağımlılıkların çoğu, Apigee'nin kontrolü dışında olan ve dilediğiniz zaman değişebilen üçüncü taraf bileşenleri tarafından tanımlanır. Bu nedenle, belgelerde her bağımlılığın açık sürüm numarası listelenmez.

İnternet erişimi olan bir makinede yükleme gerçekleştiriyorsanız düğüm, gerekli BGBG'leri ve bağımlılıkları indirebilir. Ancak internet erişimi olmayan bir düğümden kurulum 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 depoya dahil edilmesini sağlamanın tek yolu, yükleme denemesi yapmak, eksik bağımlılıklarını tespit etmek ve yükleme başarılı olana kadar bunları yerel depoya kopyalamaktır.

Sık kullanılan 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 önbelleğini temizleyin:
    sudo yum clean all
  • Bir Edge bileşenini güncellemek için:
    sudo yum update componentName
    Örnek:
    sudo yum update talep-setup
    sudo yum update Edge-management-server

Dosya Sistemi Yapısı

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

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

<inst_root>/apigee

Kurulum, Private Cloud için Apigee Edge'i dağıtmak amacıyla aşağıdaki dosya sistemi yapısını kullanır.

Günlük Dosyaları

apigee-setup ve setup.sh komut dosyasının 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 Sunucusu günlükleri şu dizinde bulunur:

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

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

Bileşenler

Konum

Yönetim sunucusu

<inst_root>/apigee/var/log/edge-management-server

Yönlendirici

<inst_root>/apigee/var/log/edge-router

Mesaj İşleyici

<inst_root>/apigee/var/log/edge-message-processor

Apigee Qpid Sunucusu

&lt;inst_root&gt;/apigee/var/log/edge-qpid-server

Apigee Postgres Sunucusu

&lt;inst_root&gt;/apigee/var/log/edge-postgres-server

Edge kullanıcı arayüzü

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

<inst_root>/apigee/var/log/apigee-zookeeper

OpenLDAP

<inst_root>/apigee/var/log/apigee-openldap

Cassandra

<inst_root>/apigee/var/log/apigee-cassandra

Qpidd

&lt;inst_root&gt;/apigee/var/log/apigee-qpidd

PostgreSQL veritabanı

<inst_root>/apigee/var/log/apigee-postgresql

Veriler

Bileşenler

Konum

Yönetim sunucusu

<data_root>/apigee/data/edge-management-server

Yönlendirici

<data_root>/apigee/data/edge-router

Mesaj İşleyici

&lt;data_root&gt;/apigee/data/edge-message-processor

Apigee Qpid aracısı

<data_root>/apigee/data/edge-qpid-server

Apigee Postgres aracısı

<data_root>/apigee/data/edge-postgres-server

ZooKeeper

&lt;data_root&gt;/apigee/data/apigee-zookeeper

OpenLDAP

&lt;data_root&gt;/apigee/data/apigee-openldap

Cassandra

<data_root>/apigee/data/apigee-cassandra/data

Qpidd

<data_root>/apigee/data/apigee-qpid/data

PostgreSQL veritabanı

<data_root>/apigee/data/apigee-postgres/pgdata

Yükleme sonrası görevler

Yükleme tamamlandıktan sonra Edge bileşenlerinde ek işlemler yapabilirsiniz.

Kurulumdan sonra Edge bileşenlerini yapılandırma

Edge'i yükleme işleminden sonra yapılandırmak için .properties dosyalarını ve Edge yardımcı programlarını birlikte 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 belirlemek için 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 bulunur. 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üzenleyin ve ardından 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. Bu, güncellemenin bileşende ayarladığınız tüm özellikleri koruduğu anlamına gelir.

Edge yapılandırması hakkında daha fazla bilgi için Edge'i Yapılandırma başlıklı makaleyi inceleyin.

Edge bileşenlerinde komutları çağırma

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

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

Bileşenleri tek tek kontrol etmek 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 action

Örneğin, Uç Yönlendirici'yi yeniden başlatmak için:

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

/opt/Apigee dizinini inceleyerek düğüme yüklü bileşenlerin listesini belirleyebilirsiniz. Bu dizin, düğüme yüklenen her Edge bileşeni için bir alt dizin içerir. Her alt dizin, şu ön eklerden birine sahiptir:

  • apigee: Edge tarafından kullanılan bir üçüncü taraf bileşenidir. Örneğin, apigee-cassandra.
  • edge: Apigee'nin sunduğu bir Edge bileşeni. Örneğin, edge-management-server.
  • edge-mint: Bir Para Kazanma bileşeni. Örneğin, edge-mint-management-server.
  • baas: API BaaS bileşeni. Örneğin baas-usergrid.

Bir bileşenin işlemlerinin tam listesi bileşene bağlıdır ancak tüm bileşenler aşağıdaki işlemleri destekler:

  • başla, durdur, yeniden başlat
  • durum, sürüm
  • yedekleme, geri yükleme
  • install, uninstall