Edge Kurulumuna Genel Bakış

Edge for Private Cloud s. 4.16.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.
• Ö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.16.09.sh dosyasını indirin ve /tmp/bootstrap_4.16.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ü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.

Postgres ana bekleme modunu yapılandırma replika

Varsayılan olarak, Edge tüm Postgres düğümlerini ana modda yükler. Ancak üretim sistemlerinde birden çok Postgres düğümüyle, bunları ana bekleme çoğaltmasını kullanacak şekilde yapılandırırsınız. Böylece, başarısız olursa bekleme düğümü trafiği sunmaya devam edebilir. Postgres için Ana Bekleme Modunda Çoğaltma Oluşturma başlıklı makaleye bakı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'i yükleme, kaldırma ve güncelleme işlemleri için Edge 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.

Bir kullanıcıyı "Apigee"ye tam sudo erişimine sahip olacak şekilde yapılandırmak için kullanıcı için sudoers dosyasını ekle:

installUser        ALL=(apigee)      NOPASSWD: ALL

Burada installUser, üzerinde çalışan kişinin kullanıcı adıdır. Kenar.

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.

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.

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

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.

Sanal ana makine kurulumu

Uçtaki bir sanal ana makine, bir API proxy'sinin üzerinde bulunduğu alan adlarını ve Uç Yönlendirici bağlantı noktalarını tanımlar ve uygulamaların bir API proxy'sine erişmek için kullandığı URL. Sanal ana makine de API proxy'sine HTTP protokolü kullanılarak mı yoksa şifrelenmiş HTTPS ile mi erişildiğini tanımlar protokolü.

Edge'e ilk katılım sürecinin bir parçası olarak bir kuruluş, ortam, sanal ana makine. Edge, bu işlemi kolaylaştırmak için setup-org komutunu sağlar yeni kullanıcılara ulaşabilirsiniz.

Sanal ana makine oluşturduğunuzda aşağıdaki bilgileri belirtmeniz gerekir:

• API'nizde ona referans vermek için kullandığınız sanal ana makinenin adı proxy'ler.
• Sanal ana makine için Yönlendirici üzerindeki bağlantı noktası. Genellikle bu bağlantı noktaları ve her yeni sanal ana makine için bir birim artar.
• Sanal ana makinenin ana makine takma adı. Genellikle sanal makinenin DNS adı ana bilgisayar.

Uç Yönlendirici, gelen isteğin Ana Makine başlığını isteği işleyen API proxy'sini belirlemenin bir parçası olarak kullanılabilir ana makine takma adlarının listesine eklenir. Sanal ana makine üzerinden istekte bulunurken, ana makineyle eşleşen bir alan adı belirtin. takma adı kullanabilir veya Yönlendiricinin IP adresini ve ana makine takma adını içeren Ana Makine başlığını belirtin.

Örneğin, bağlantı noktasında myapis.Apigee.net ana makine takma adıyla bir sanal ana bilgisayar oluşturduysanız 9001, daha sonra bu sanal ana makine üzerinden bir API'ye gönderilen cURL isteği aşağıdakilerden birini kullanabilir formlar:

• myapis.apigee.net için DNS girişiniz varsa:
  
  curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}
• myapis.apigee.net için DNS girişiniz yoksa:
  
  curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.Apigee.net'
  
  Bu formda IP adresini belirtirsiniz ve Ana makine üstbilgisine ana makine takma adını iletin.
  .
  . Not: curl komutu, çoğu tarayıcı ve diğer birçok yardımcı program otomatik olarak İsteğin bir parçası olarak Ana makine başlığını, istek kapsamında alanla birlikte ekleyin. Böylece, curl'ü kullanabilirsiniz. komutunu çalıştırın:
  
  . curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}

Şu durumda kullanabileceğiniz seçenekler: sanal ana makine için bir DNS girişine sahip değil

DNS girişiniz yoksa kullanabileceğiniz seçeneklerden biri, ana makine takma adını Sanal ana makinenin yönlendiricisi ve bağlantı noktası, yani <routerIP>:port. Örneğin:

192.168.1.31:9001

Daha sonra, aşağıdaki formda bir curl komutu oluşturursunuz:

curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} 

Edge kullanıcı arayüzüyle iyi çalıştığından bu seçenek tercih edilir.

Birden fazla Yönlendiriciniz varsa her bir Yönlendirici için IP adresini belirterek bir ana makine takma adı ekleyin. her Yönlendirici ve sanal ana makine bağlantı noktası.

Alternatif olarak, ana makine takma adını temp.hostalias.com. Ardından, her istekte Ana makine başlığını iletmeniz gerekir:

curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path}  -H 'host: temp.hostalias.com'

İsterseniz ana makine takma adını /etc/hosts dosyanıza da ekleyebilirsiniz. Örneğin, şu satırı /etc/hosts öğesine ekleyin:

192.168.1.31   temp.hostalias.com

Ardından, DNS girişiniz varmış gibi bir istekte bulunabilirsiniz:

curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}

Edge bileşenlerini yapılandırma yayını kurulum

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

Uç Yönlendirici'nin şunları yapabildiğinden emin olun: /etc/rc.d/init.d/functions adresine erişim

Uç Yönlendirici ve BaaS Portalı hem Nginx yönlendiriciyi kullanır hem de /etc/rc.d/init.d/functions.

Güvenlik işleminiz /etc/rc.d/init.d/functions ile ilgili izinleri ayarlamanızı gerektiriyorsa 700 olarak ayarlamazsanız yönlendirici başlatılamaz. İzin vermek için izinleri 744 olarak ayarlayabilirsiniz /etc/rc.d/init.d/functions için okuma erişimi.

Edge bileşenlerinde komut çağırma

/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

Günlük dosyalarına erişme

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

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:

<inst_root>/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ı

Veriler