Edge Kurulumuna Genel Bakış

Edge for Private Cloud s. 4.17.09

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:

• 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 daha fazla.
• Cassandra kimlik doğrulamasını etkinleştirmek isteyip istemediğinize karar verin.
• Postgres için ana bekleme replikası ayarlamak 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 Yükleme Topolojileri bölümüne bakın.
• Seçtiğiniz topolojideki her düğümde Edge Apigee-setup yardımcı programını yükleyin:
  • Edge bootstrap_4.17.09.sh dosyasını indirin ve /tmp/bootstrap_4.17.09.sh olarak değiştirin.
  • Edge apigee-service yardımcı programını yükleyin ve ve bildirmeyi konuştuk.
  • Edge Apigee-setup yardımcı programını ve bağımlıları yükleyin.
    .
    . Bkz. Edge'yi Yükleme Apigee-setup yardımcı programı kullanın.
• Apigee-setup kullanma bağlı olarak her düğüme bir veya daha fazla Edge bileşeni yükleme yardımcı programı topolojiyi inceleyin.
  . Edge bileşenlerini bir düğüme yükleme düğüm.
• 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.

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, remove, update.
  • Apigee-all komutları: install, remove, 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, gerekli değilse root veya tam sudo erişimi.)
• 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ı:
  • start, stop, restart, configuration gibi apigee-service komutlarını kullanabilir.
  • start, stop, restart, configuration gibi Apigee-all komutlarını kullanabilir.

Şununla bir kullanıcı oluşturma: "Apigee"ye tam sudo erişimi 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, üzerinde çalışan kişinin kullanıcı adıdır. Kenar.

İzinlerin ayarlanması açık yapılandırma dosyaları

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. Dosyanın sahibini "Apigee:Apigee"ye alçlama veya Edge'i çalıştıran kullanıcıyı değiştirdiyseniz "Apigee" hizmetinden alınan hizmet dosyayı Edge'i çalıştıran kullanıcıya chown geliştirmenizi sağlar.

Ayırılıyor Kök kullanıcı ve kök olmayan kullanıcı arasında uç yükleme görevleri

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.17.09.sh dosyasını indirip çalıştırın:
      > curl https://software.Apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      > sudo bash /tmp/bootstrap_4.17.09.sh Apigeeuser=uName apigeepassword=pWord
      
      Bu adım, apigee-service yardımcı programını yükler ve "Apigee" belirtir.
   2. Bir kullanıcıyı "Apigee"ye tam sudo erişimine sahip olacak şekilde yapılandırma açıklandığı şekilde kullanıcı bölümünü ziyaret edin.
   3. Apigee-setup yardımcı programını yükleyin:
      > /opt/Apigee/Apigee-service/bin/potansiyel-service oluşturulmuş-setup yükleme
   4. Yüklemek için Apigee-setup yardımcı programını kullanma Düğümdeki uç BGBG'leri:
      > /opt/Apigee/Apigee-service/bin/potansiyel-service compName yükle
      
      Düğüme yüklediğiniz Edge BGBG'leri topolojinize bağlıdır. Mevcut öğeler listesi bileşenler şunları içerir: Apigee-enabling, Apigee-Validate, Apigee-zookeeper, Apigee-cassandra, Apigee-openLDAP, Edge-ui, uç-yönetim-sunucusu, uç-ui, uç-yönlendirici, Edge-message-processor, Apigee-postgresql, Apigee-qpidd, Edge-postgres-server, edge-qpid-server.
2. Kök kullanıcı düğüme Uç BGBG'leri yükledikten sonra "Apigee"ye tam sudo erişimi Kullanıcı yapılandırma işlemini tamamlar:
   1. setup.sh dosyasını kullanın yardımcı programını tamamlayın. Form komutu, düğüme yüklediğiniz bileşenlere bağlıdır. 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 yapmak için şu komutu kullanın:
      > /opt/Apigee/Apigee-setup/bin/setup.sh -p aio -f configFile

Kurulum yapılandırmasının yeri dosyalar

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, /usr/local/var içinde veya /usr/local/share dizini bunu düğüme ekleyin ve bunu "Apigee:Apigee" olarak değiştirin.

Edge sistemi dışında yapılandırma dosyasındaki tüm bilgiler gereklidir şifresini girin. Şifreyi unutursanız Apigee-setup yardımcı programı şifreyi girmenizi ister komutunu çalıştırın.

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

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.

İ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ğ.
  .
  . Not: Apigee, herkese açık platformumuzda tüm üçüncü taraf bağımlılıklarını barındırmaz. ekleyebilirsiniz. Bu bağımlılıkları herkesin erişebileceğinden indirip yüklemeniz gerekir ekleyebilirsiniz.
  .
  . 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.

Şu işlemler için yerel Edge deposu kullanma: Edge sürümünüzün bakımını yapın

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).

Bununla birlikte, harici bir kod deposuna sahip düğümler için bile, yerel depo kullanmanın internet bağlantısı. Edge'i Apigee herkese açık deposundan yüklediğinizde her zaman güncel Kenar BGBG'lerine sahip. Dolayısıyla, belirli bir boyut için Edge BGBG'lerini indirip depolamak kullanıyorsanız bu Edge sürümü için yerel depo oluşturmanız gerekir. Daha sonra bu yerel depoyu kullanarak, Edge'in herhangi bir sürümünde yükleme işlemi gerçekleştirebilirsiniz.

Örneğin, ilk olarak bir Edge geliştirme ortamı yüklemek için yerel depoyu kullanacaksınız. Ardından, bir üretim ortamına geçmeye hazır olduğunuzda Edge'i yerel sunucudan kod deposudur. Yerel depodan yükleme yaparak geliştirme ve üretim işlemlerinizin eşleşmesini sağlar.

Yansıtılmış depo çok esnektir. Örneğin şuradan yansıtılmış bir depo oluşturabilirsiniz: veya Edge'in belirli bir sürümünden gelen güncelleştirmeler kullanabilirsiniz. Depoyu oluşturduktan sonra şunları da yapabilirsiniz: ekleyerek farklı Edge sürümlerinden BGBG'ler ekleyebilirsiniz. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme daha fazla.

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 clear all
• Bir Edge bileşenini güncellemek için:
  sudo yum güncelleme componentName
  Örneğin:
  sudo yum update Apigee-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 dizininin yön:

/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 günlük dosyası setup.sh komut dosyası /tmp/setup-root.log konumuna yazılır.

Her bileşene ait günlük dosyaları /opt/apigee/var/log dizininde bulunur. Her bileşen kendine ait bir alt dizine sahiptir. Örneğin, Yönetim Sunucusu'nun günlükleri, dizin:

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

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

Bileşenler	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
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şenler	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

Kurulum sonrası görevler

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

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 ve Edge yardımcı programlarının bir kombinasyonunu kullanırsınız. Örneğin, Örneğin, Edge kullanıcı arayüzünde TLS/SSL'yi yapılandırmak için .properties dosyalarını geliştirmenize yardımcı olur. .properties dosyalarında yapılan değişiklikler için şunları yapmanız gerekir: Etkilenen Edge bileşenini yeniden başlatın.

.properties dosyaları şu konumda bulunur: /opt/apigee/customer/application dizinine eklenir. 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 yeniden başlatın bileşen:

> /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, varsayılan tarayıcıdaki .properties dosyaları /opt/apigee/customer/application okunduğundan emin olun. Bu, güncellemenin bileşende ayarladığınız tüm özellikleri koruyacağı anlamına gelir.

Chrome Web Mağazası'nda daha fazla bilgi için Edge'yi Yapılandırma Edge yapılandırması.

Edge'de komutları çağırma bileşenler

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

/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ı aşağıdaki 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. O dizin düğümde yüklü her Edge bileşeni için bir alt dizin içerir. Her bir alt dizin öneki:

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

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:

• başla, durdur, yeniden başlat
• durum, sürüm
• yedekleme, geri yükleme
• yükleme, kaldırma