Edge Kurulumuna Genel Bakış

Edge for Private Cloud 4.18.05 sürümü

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.18.05.sh dosyasını şuraya indirin: /tmp/bootstrap_4.18.05.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.

     Edge Apigee-setup yardımcı programını yükleme bölümüne bakı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-sağlama yüklemesi için Apigee-setup yardımcı programını kullanın, Edge kuruluşlarını oluşturmak ve yönetmek için kullandığınız yardımcı programlar hakkında bilgi edinin.

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

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

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.18.05.sh dosyasını indirin ve ç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"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:

Veriler

Kurulum sonrası görevler

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

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

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'i yapılandırma kurulum sonrası bileşenler

Edge'i yükleme işleminden sonra yapılandırmak için .properties dosyalarının bir kombinasyonunu kullanırsınız ve Edge yardımcı programları. Örneğin, Edge kullanıcı arayüzünde TLS/SSL'yi yapılandırmak için .properties dosyaları kullanarak gerekli özellikleri ayarlayabilirsiniz. .properties ile ilgili değişiklikler dosyaları, etkilenen Edge bileşenini yeniden başlatmanızı gerektirir.

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

Bir bileşen için özellik ayarlamak üzere karşılık gelen .properties dosyasını düzenleyin ve daha sonra 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, .properties dosyaları /opt/apigee/customer/application dizini okundu. Bu, güncellemenin bileşende ayarladığınız tüm özellikler.

Daha fazla bilgi için Edge'yi yapılandırma başlıklı makaleye Edge yapılandırması.

Edge bileşenlerinde komut çağırma

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

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

apigee-service yardımcı programını kullanma tek tek bileşenleri kontrol edin ve yapılandırı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, ve apigee-service adlı kampanyayı yürütürsünüz. Yapılandırmanıza bağlı olarak, component_name ş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 apigee-service öğesini şurada da çağırabilirsiniz: Size bağlı olarak apigee-provision ve apigee-validate bileşenleri yapılandırma.

Ö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

Düğümde yüklü bileşenlerin listesini, /opt/apigee dizini. Bu dizinde her Edge için bir alt dizin bulunur bileşeninin yüklenmesidir. Her bir alt dizine şu ön ek eklenir:

• apigee: Edge'in kullandığı bir üçüncü taraf bileşeni. Örneğin, apigee-cassandra
• edge: Apigee'nin bir Edge bileşenidir. Örneğin, edge-management-server
• edge-mint: Bir Para Kazanma bileşeni. Örneğin: edge-mint-management-server

Bir bileşene ilişkin işlemlerin tam listesi bileşenin kendisine bağlıdır, ancak bileşenler aşağıdaki işlemleri destekler:

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

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.