Yüklemeyle İlgili Dikkat Edilmesi Gereken Noktalar

Edge for Private Cloud s. 4.16.05

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 tıklayın.

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.05.sh dosyasını şuraya indirin: /tmp/bootstrap_4.16.05.sh olarak değiştirin.
    • 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ıları yükleyin.

      Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.
  • 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, birden fazla Postgres düğümü olan üretim sistemlerinde, ana düğümün arızalanması durumunda yedek düğümün sunucu trafiğine devam edebilmesi için düğümleri ana-yedek çoğaltma kullanacak şekilde yapılandırırsınız. 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, 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, 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ı:
    • Başlat, durdur, yeniden başlat, yapılandır gibi apigee-service komutları.
    • start, stop, restart, configuration gibi apigee-all komutlarını kullanabilir.

Bir kullanıcıyı "apigee" kullanıcısına tam sudo erişimi olacak şekilde yapılandırmak için sudoers dosyasını düzenleyerek aşağıdakileri ekleyin:

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" kullanıcısının erişebilmesi gerekir. 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çık olduğundan emin olun:

  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.

Edge bileşenlerinin sessiz yüklenmesi

Apigee-setup yardımcı programına bu bilgileri içeren kurulum hakkında bilgi edindik. Sessiz yüklemelerde tek şart, yapılandırma dosyasının "Apigee" tarafından erişilebilir veya okunaklı olması gerekir belirtir. Örneğin, bunu düğümdeki /tmp dizinine ekleyebilir ve "Apigee:Apigee" öğesine chown koyabilirsiniz.

Edge sistem yöneticisinin şifresi dışında yapılandırma dosyasında bulunan tüm bilgiler gereklidir. Şifreyi unutursanız Apigee-setup yardımcı programı sizden komut satırından silebilirsiniz.

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, dahili olarak oluşturduğunuz Apigee deposunun kopyalanan bir sürümüne erişebilir. 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ğ.

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. İlgili içeriği oluşturmak için kullanılan yerel deponuza tüm bağımlılıkların dahil edilmesini garanti etmenin tek yolu, bulunana kadar eksik bağımlılıkları belirleyin ve bunları yerel depoya kopyalayın. emin olmanız gerekir.

Sanal ana makine oluşturma

Edge'deki sanal ana makine, API proxy'sinin kullanıma sunulduğu alanları ve Edge Router bağlantı noktalarını ve dolayısıyla uygulamaların API proxy'sine erişmek için kullandığı URL'yi tanımlar. 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 proxy'lerinizde referans vermek için kullandığınız sanal ana makinenin adı.
  • 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://<yönlendiriciIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'

    Bu formda, yönlendiricinin IP adresini belirtir ve ana makine takma adını Host başlığında iletirsiniz.

    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://&lt;routerIP&gt;: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 &lt;routerIP&gt;: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, etkilenen Edge bileşenini yeniden başlatmanızı gerektirir.

.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 koruduğu 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 izinler 744 olarak ayarlanabilir /etc/rc.d/init.d/functions için okuma erişimi.

Edge bileşenlerinde komutları çağırma

Edge, /opt/apigee/apigee-service/bin altında Edge kurulumunu yönetmek için kullanabileceğiniz yönetim yardımcı programlarını yükler. Ö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, Edge Yönlendiriciyi 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şenin günlük dosyaları /opt/apigee/var/log dizininde bulunur. Her bileşenin kendi alt dizini vardır. Ö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ı

Bileşenler

Konum

Yönetim Sunucusu

&lt;inst_root&gt;/apigee/var/log/edge-management-server

Yönlendirici

&lt;inst_root&gt;/apigee/var/log/edge-router

Mesaj İşleyici

<inst_root>/apigee/var/log/edge-message-processor

Apigee Qpid Sunucusu

&lt;inst_root&gt;/apigee/var/log/edge-qpid-server

Apigee Postgres Sunucusu

&lt;inst_root&gt;/apigee/var/log/edge-postgres-server

Edge kullanıcı arayüzü

&lt;inst_root&gt;/apigee/var/log/edge-ui

ZooKeeper

&lt;inst_root&gt;/apigee/var/log/apigee-zookeeper

OpenLDAP

&lt;inst_root&gt;/apigee/var/log/apigee-openldap

Cassandra

&lt;inst_root&gt;/apigee/var/log/apigee-cassandra

Qpidd

&lt;inst_root&gt;/apigee/var/log/apigee-qpidd

PostgreSQL veritabanı

&lt;inst_root&gt;/apigee/var/log/apigee-postgresql

Veriler

Bileşenler

Konum

Yönetim Sunucusu

&lt;data_root&gt;/apigee/data/edge-management-server

Yönlendirici

&lt;data_root&gt;/apigee/data/edge-router

Mesaj İşleyici

&lt;data_root&gt;/apigee/data/edge-message-processor

Apigee Qpid aracısı

&lt;data_root&gt;/apigee/data/edge-qpid-server

Apigee Postgres aracısı

&lt;data_root&gt;/apigee/data/edge-postgres-server

ZooKeeper

&lt;data_root&gt;/apigee/data/apigee-zookeeper

OpenLDAP

&lt;data_root&gt;/apigee/data/apigee-openldap

Cassandra

<data_root>/apigee/data/apigee-cassandra/data

Qpidd

&lt;data_root&gt;/apigee/data/apigee-qpid/data

PostgreSQL veritabanı

&lt;data_root&gt;/apigee/data/apigee-postgres/pgdata