Edge Kurulumuna Genel Bakış

Tipik bir Edge kurulumu, birden fazla düğüme dağılmış 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:

  1. Düğümde SELinux'u devre dışı bırakın veya izin verilen moda ayarlayın. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme bölümüne göz atın.
  2. Cassandra kimlik doğrulamasını etkinleştirmek isteyip istemediğinize karar verin.
  3. Postgres için ana bekleme bekleme replikası oluşturmak isteyip istemediğinize karar verin.
  4. Önerilen topoloji 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.50.00.sh dosyasını /tmp/bootstrap_4.50.00.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 sayfasına göz atı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.

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

  7. Yönetim Sunucusu düğümünde, apigee-setup yardımcı programını kullanarak apigee-provision uygulamalarını (Uç kuruluşlarını oluşturmak ve yönetmek için kullandığınız yardımcı programlar) yükleyin.

    Daha fazla bilgi için Kuruluşa kaydolma başlıklı makaleye bakın.

  8. Yükleme işlemi tamamlandıktan sonra, aşağıdaki örnekte gösterildiği gibi Klasik kullanıcı arayüzü bileşenini her düğümde yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  9. (Önerilir) İlk kurulumu tamamladıktan sonra Apigee, Özel Bulut için Apigee Edge'in geliştiricileri ve yöneticileri için gelişmiş bir kullanıcı arayüzü olan yeni Edge kullanıcı arayüzünü (bileşen adı edge-management-ui olan) yüklemenizi önerir.

    Daha fazla bilgi için Yeni Edge kullanıcı arayüzünü yükleme başlıklı makaleye bakın.

Yükleme tamamlandığında sık karşılaşılan yükleme sonrası işlemlerin listesine göz atın.

Yüklemeyi kim gerçekleştirebilir?

Apigee Edge dağıtım dosyaları, bir BGBG ve bağımlılık grubu olarak yüklenir. Edge RPM'lerini yüklemek, kaldırmak ve güncellemek için komutların kök kullanıcı veya tam sudo erişimi olan bir kullanıcı tarafından çalıştırılması gerekir. Tam sudo erişimi için kullanıcının kök ile aynı işlemleri gerçekleştirmek üzere sudo erişimi olması gerekir.

Aşağıdaki komutları veya komut dosyalarını çalıştırmak isteyen kullanıcıların kök olması ya da tam sudo erişimi olan bir kullanıcı 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ını kullanın (Gerekli BGBG'leri yüklemek için "apigee-service install" yöntemini zaten kullanmadığınız sürece. Daha sonra 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ı da oluşturur. Birçok Edge komutu, "Apigee" kullanıcısı olarak çalıştırmak için sudo'yu çağırır.

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

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

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

Bir kullanıcıyı "Apigee" kullanıcısına tam sudo erişimi olacak şekilde yapılandırmak için sudoers dosyasını eklemek üzere "visudo" komutunu kullanın:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

Yapılandırma dosyaları için izinleri belirleme

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

Bir yapılandırma dosyası oluştururken, dosyanın Edge komutları tarafından erişilebilir olmasını sağlamak için 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 ekleyin.

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

Edge yükleme işleminin tamamını kök olarak veya tam sudo erişimi olan 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 dizin tarafından gerçekleştirilen görevler ve "Apigee" kullanıcısına tam sudo erişimi olan kullanıcı tarafından gerçekleştirilen görevler olarak ayırabilirsiniz.

  1. Kök tarafından gerçekleştirilen görevler:
    1. bootstrap_4.50.00.sh dosyasını indirip çalıştırın:
      curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
      sudo bash /tmp/bootstrap_4.50.00.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 kullanıcı oluşturma bölümünde açıklandığı şekilde "Apigee" kullanıcısına tam sudo erişimi 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 şunları içerir: 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üğümde 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 Düğüm bileşenlerini bir düğüme yükleme başlıklı makaleye 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.

      Alternatif olarak, hepsi bir arada yükleme yapmak 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

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 okunabilmesidir. Örneğin, dosyayı düğümdeki /usr/local/var veya /usr/local/share dizinine ve chown "Apigee:Apigee" dizinine yerleştirin.

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

Daha fazla bilgi için Düğüm bileşenlerini düğüme yükleme başlıklı makaleye göz atın.

Yükleme hatası işleme

Bir Edge bileşeninin yüklenmesi sırasında bir hata meydana gelirse, sorunu gidermeyi ve ardından yükleyiciyi tekrar çalıştırmayı deneyebilirsiniz. Yükleyici, bir hata tespit ettiğinde veya bileşen yüklendikten sonra daha sonra değiştirmek ya da güncellemek istediğinizde, tekrar tekrar çalışacak şekilde tasarlanmıştır.

Yükledikten veya yükselttikten sonra Edge kullanıcı arayüzü bileşenini çalıştırdığı her düğümde yeniden başlatın.

İ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'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, Apigee kod deposunun dahili olarak ayarladığınız yansıtılmış bir sürümüne erişebilir. Bu veri havuzu, tüm Edge BGBG'lerini içerir ancak dahili ağda depolardan diğer tüm bağımlıların mevcut olduğundan emin olmanız gerekir.

    Dahili Apigee deposu oluşturmak için harici internet erişimi olan bir düğümün Edge BGBG'lerini ve bağımlılıkları indirebilmesi gerekir. Dahili depoyu oluşturduktan sonra 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ün bakımını yapmak 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.

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

Apigee Edge dağıtım dosyaları, her biri kendi yükleme bağımlılarına sahip olabilecek bir BGBG dosyası 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ının açık sürüm numarası listelenmez.

İnternet erişimi olan bir makinede yükleme işlemi 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ıları içeren dahili bir depo oluşturursunuz. Tüm bağımlıların yerel deponuza dahil edildiğinden emin olmanın tek yolu, yüklemeyi denemek, eksik bağımlılıkları belirlemek ve kurulum 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şenlerin yüklenmesi ve güncellenmesi için Yum'a ihtiyaç duyar. Bir düğümdeki kurulumu 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, tüm dosyaları /opt/apigee dizinine yükler.

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

/opt/apigee

Yüklemede, Apigee Edge'i Private Cloud'a 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ı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 dizindedir:

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

Aşağıdaki tablolarda, günlük dosyalarının konumu 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. Diğer günlükler için şuraya göz atın:

/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
Klasik kullanıcı arayüzü (bileşen adı edge-management-ui olan yeni Edge kullanıcı arayüzü değil) /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/system.log
Qpidd /opt/apigee/var/log/apigee-qpidd
PostgreSQL veritabanı /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

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
apigee-monit /opt/apigee/data/apigee-monit

Yükleme sırasında sistem kontrolünü etkinleştirin

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

ENABLE_SYSTEM_CHECK=y

Bu özelliği "y" olarak ayarlarsanız yükleyici, sistemin yüklenen bileşen için 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.