Edge Kurulumuna Genel Bakış

Tipik bir Edge yüklemesi birden fazla düğüme dağıtılan Edge bileşenlerinden oluşur. Edge'i bir düğüme yükledikten sonra düğüm.

Yükleme işlemi

Edge'in bir düğüme yüklenmesi birden çok adımdan oluşur:

  1. Düğümde SELinux'u devre dışı bırakın veya serbest moda ayarlayın. Görüntüleyin Bu SDK için Edge Apigee-setup yardımcı programını yükleme daha fazla.
  2. Cassandra kimlik doğrulamasını etkinleştirmek isteyip istemediğinize karar verin.
  3. Postgres için ana bekleme replikası 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. Görüntüleyin Kurulum Topolojileri hakkında daha fazla bilgi edinin.
  5. Seçtiğiniz topolojideki her bir düğüme Edge apigee-setup yardımcı programını yükleyin:
    • Edge bootstrap_4.52.02.sh dosyasını şuraya indirin: /tmp/bootstrap_4.52.02.sh.
    • 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.

      Bkz. Edge'yi Yükleme Apigee-setup fayda sağlayın.

  6. Her cihaza bir veya daha fazla Edge bileşeni yüklemek için apigee-setup yardımcı programını kullanın düğümünü seçin.

    Edge 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 Edge'i oluşturmak ve yönetmek için kullandığınız yardımcı programlar apigee-provision kuruluşlar.

    Daha fazla bilgi için Kuruluşa ilk katılım bölümünü inceleyin.

  8. Yükleme tamamlandıktan sonra her düğümde Klasik kullanıcı arayüzü bileşenini yeniden başlatın. aşağıdaki örnekte gösterildiği gibi:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  9. (Önerilir) İlk yüklemeyi tamamlamanızın ardından Apigee, yeni Edge kullanıcı arayüzünü (bileşen adı edge-management-ui) sağlayan gelişmiş bir özel Cloud için Apigee Edge'in geliştiricileri ve yöneticileri ile iletişime geçin.

    Daha fazla bilgi için Yeni Edge kullanıcı arayüzünü yükleme bölümüne bakın.

Yükleme tamamlandıktan sonra bu listeye göz atın. sık karşılaşılan yükleme sonrası işlemler.

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

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

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

  • 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ı (önceden kullanmadıysanız "apigee-service install" gereken BGBG'leri yükleyin. Daha sonra, root veya tam sudo erişimi sağlayamazsınız.)
  • Edge bileşenlerini güncellemek için update.sh komut dosyası

Ayrıca, Edge yükleyici sisteminizde "Apigee" adında yeni bir kullanıcı oluşturur. Birçok Edge komutu "Apigee" olarak çalıştırmak için sudo'yu çağırma belirtir.

Yukarıda gösterilenlerin dışındaki tüm komutları çalıştırmak isteyen kullanıcılar "Apigee"ye tam sudo erişimi belirtir. Bu komutlar şunlardır:

  • Aşağıdakiler dahil olmak üzere apigee-service yardımcı programı komutları:
    • apigee-service komutları (start, stop, restart, configure gibi).
    • Apigee-all komutları (ör. start, stop, restart, configure)

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

Bir kullanıcıyı "Apigee"ye tam sudo erişimine sahip olacak şekilde yapılandırmak için kullanıcı için "visudo" komutuna şunu eklemek için sudoers dosyasını düzenleyin:

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ı tarafından kullanılan tüm dosyalara veya kaynaklara "Apigee" tarafından erişilebilir olmalıdır. belirtir. Bu Edge lisans dosyasını ve tüm yapılandırma dosyalarını içerir.

Yapılandırma dosyası oluştururken dosyanın sahibini "Apigee:Apigee" olarak değiştirebilirsiniz. sağlamak için Edge komutlarının erişimine açıktır:

  1. Dosyayı bir düzenleyicide herhangi bir kullanıcı olarak oluşturun.
  2. chown dosya sahibini "Apigee:Apigee" kullanıcısına ekleyin veya kullanıcıyı değiştirdiyseniz Edge hizmetini "Apigee" sürümünden çalıştırma işlemini yapan kullanıcıya, dosyayı kullanıma sunuyoruz.

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

Edge yükleme işleminin tamamını root olarak veya uygulamayı yükleyen bir kullanıcı tarafından gerçekleştirmek en kolay yöntem olsa da tam sudo erişimine sahip olduğu için bu her zaman mümkün değildir. Bunun yerine, kök tarafından gerçekleştirilen görevlere ve kök tarafından gerçekleştirilen görevlere "Apigee"ye tam sudo erişimi belirtir.

  1. Kök tarafından gerçekleştirilen görevler:
    1. bootstrap_4.52.02.sh dosyasını indirin ve çalıştırın:
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

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

    2. Bir kullanıcıyı "Apigee"ye tam sudo erişimine sahip olacak şekilde yapılandırma aşağıdaki adımları izleyin: "Apigee" için tam sudo erişimine sahip kullanıcı oluşturma kullanıcı.
    3. apigee-setup yardımcı programını yükleyin:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. Düğüme Edge BGBG'lerini 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. Görev listesi kullanılabilen bileşenler şunlardır: 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ı yapılandırma işlemini tamamlar:
    1. Edge yapılandırmasını tamamlamak için setup.sh yardımcı programını kullanın nerede olduğunu anlayabilirsiniz. Komutun biçimi, yüklediğiniz komutun yüklü olması gerekir. Tam liste için bkz. Edge bileşenlerini bir düğüme yükleyin.

      Örneğin, ZooKeeper ve Cassandra'nın yüklemesini tamamlamak için aşağıdaki kodu kullanın: komut:

      /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 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 hakkında daha fazla bilgi edinin. Sessiz yüklemelerde tek şart, yapılandırma dosyasının "Apigee" tarafından erişilebilir veya okunaklı olması gerekir belirtir. Örneğin, düğümdeki /usr/local/var veya /usr/local/share dizininde ve chown değerini "Apigee:Apigee"ye ekleyin.

Edge sistemi dışında yapılandırma dosyasındaki tüm bilgiler gereklidir şifresini girin. Şifreyi belirtmezseniz apigee-setup yardımcı programı istemde bulunur komut satırına girmeniz gerekiyor.

Daha fazla bilgi için Edge bileşenlerini bir düğüme yükleme başlıklı makaleye bakın.

Yükleme hatasını işleme

Edge bileşeni kurulurken hata oluşursa hatayı düzeltmeyi deneyebilirsiniz seçin ve yükleyiciyi tekrar çalıştırın. Yükleyici, tekrar tekrar çalıştırılacak şekilde tasarlanmıştır: veya bir bileşeni daha sonra değiştirmek ya da güncellemek isterseniz teşekkür ederiz.

Yükleme veya yükseltme işleminden sonra, sağlandığından emin olmak için çalışıyor.

İnternetten 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'i yüklemek için Apigee deposuna erişir BGBG'ler ve bağımlılıklar.

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

    Harici internet bağlantısı olmayan düğümler Apigee'nin yansıtılmış sürümüne erişebilir veya dahili olarak oluşturduğunuz bir depoda yer alır. Bu depo, tüm Edge BGBG'lerini içerir ancak depolarda bulunan diğer tüm bağımlılıklarınızın dahilinde bulunan ağ.

    Dahili Apigee deposunu oluşturmak için harici internet bağlantısı olan bir düğüme ihtiyacınız var Edge BGBG'lerini ve bağımlılıklarını indirebilmek için gereklidir. Dosyayı oluşturduktan sonra dahili deponuzun bulunduğu bir düğüme taşımayı veya bu düğümün uç noktasının düğümleri yükleyebilirsiniz.

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

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

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

Apigee Edge dağıtım dosyaları, her biri kendi içinde bir dizi kurulum bağımlılığı vardır. Bu bağımlılıkların çoğu, üçüncü taraflarca Apigee'nin kontrolü dışında olan ve herhangi bir zamanda değişebilen bileşenler. Dolayısıyla, belgelerinde her bağımlılığın açık sürüm numarası listelenmez.

İnternet erişimi olan bir makinede yükleme yapıyorsanız düğüm, indirme işlemini ve bağımlılıkları belirlemeye çalışın. Bununla birlikte, internet bağlantısı olmayan bir düğümden yükleme yapıyorsanız genellikle gerekli tüm bağımlılıkları içeren dahili bir depo oluşturursunuz. Tek yol yerel deponuza tüm bağımlılıkların dahil edilmesini sağlamak için bir yükleme denemesi, eksik bağımlılıkları belirleyin ve kurulum tamamlanana kadar bunları yerel depoya kopyalayın. yardımcı olur.

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. En son haberleri sunan, Bir düğümdeki yüklemeyi yönetmek için birkaç Yum komutu kullanmak zorunda kalırsınız.

  • 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 İşlem Kılavuzu'nda kök yükleme dizini şu şekilde belirtilmiştir:

/opt/apigee

Kurulumda, Apigee Edge for Private'ı dağıtmak için aşağıdaki dosya sistemi yapısı kullanılır Cloud'da geliştiricilerin karşılaştığı yaygın sorunları çözmenize ve kullanım alanlarını öğrenmenize yardımcı olacak teknik belgeleri ve videoları keşfedin.

Günlük Dosyaları

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

Her bileşenin günlük dosyaları /opt/apigee/var/log içinde yer alır. dizin. Her bileşenin kendi alt dizini vardır. Örneğin, Yönetim Sunucu dizinde:

/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 aşağıdaki konulara 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) olarak değiştirildi /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ş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 CPU ve CPU yüklenmekte olan bileşen için bellek gereksinimlerinden biridir. Varsayılan değer "n"dir. devre dışı bırakmak için onay kutusunu işaretleyin.