Edge Kurulumuna Genel Bakış

Tipik bir Edge kurulumu, birden fazla düğüme dağıtılan Edge bileşenlerinden oluşur. Edge'i bir düğüme yükledikten sonra düğüme bir veya daha fazla Edge bileşeni yükleyip yapılandırırsınız.

Yükleme işlemi

Edge'i bir düğüme yüklemek çok adımlı bir işlemdir:

1. Düğümde SELinux'u devre dışı bırakın veya izin verici moda ayarlayın. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.
2. Cassandra kimlik doğrulamasını etkinleştirmek isteyip istemediğinize karar verin.
3. Postgres için ana-yedek çoğaltma 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. Daha fazla bilgi için Yükleme Topolojileri bölümüne bakın.
5. Seçtiğiniz topolojideki her düğüme Edge apigee-setup yardımcı programını yükleyin:
   • Edge bootstrap_4.53.00.sh dosyasını /tmp/bootstrap_4.53.00.sh'e indirin.
   • Edge apigee-service yardımcı programını ve bağımlılıkları yükleyin.
   • Edge apigee-setup yardımcı programını ve bağımlılıkları yükleyin.

     Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.

6. Seçtiğiniz topolojiye göre her düğüme bir veya daha fazla Edge bileşeni yüklemek için apigee-setup yardımcı programını kullanın.

   Edge bileşenlerini bir düğüme yükleme başlıklı makaleyi inceleyin.

7. Yönetim Sunucusu düğümünde apigee-setup yardımcı programını kullanarak Edge kuruluşlarını oluşturmak ve yönetmek için kullandığınız apigee-provision yardımcı programlarını yükleyin.

   Daha fazla bilgi için Kuruluşları ilk katılıma dahil etme başlıklı makaleyi inceleyin.

8. Yükleme tamamlandıktan sonra her düğümde Klasik kullanıcı arayüzü bileşenini aşağıdaki örnekte gösterildiği gibi yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9. (Önerilir) Apigee, ilk yüklemeyi tamamladıktan sonra Private Cloud için Apigee Edge'in geliştiricileri ve yöneticilerine yönelik gelişmiş bir kullanıcı arayüzü olan yeni Edge kullanıcı arayüzünü (bileşen adı edge-management-ui) yüklemenizi önerir.

   Daha fazla bilgi için Yeni Edge kullanıcı arayüzünü yükleme başlıklı makaleyi inceleyin.

Yükleme tamamlandıktan sonra sık kullanılan yükleme sonrası işlemler listesine göz atın.

Yüklemeyi kimler yapabilir?

Apigee Edge dağıtım dosyaları, bir dizi RPM ve bağımlılık olarak yüklenir. Edge BGBG'lerini yüklemek, kaldırmak ve güncellemek için komutların kök kullanıcı veya tam sudo erişimine sahip bir kullanıcı tarafından çalıştırılması gerekir. Tam sudo erişimi, kullanıcının root ile aynı işlemleri gerçekleştirmek için sudo erişimine sahip olduğu anlamına gelir.

Aşağıdaki komutları veya komut dosyalarını çalıştırmak isteyen kullanıcıların root olması veya tam sudo erişimine sahip olması gerekir:

• 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ı (Gerekli RPM'leri yüklemek için daha önce "apigee-service install"yi kullanmadıysanız. Ardından, gerekirse kök 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" kullanıcısı olarak çalıştırmak için sudo'yu çağırır.

Yukarıda gösterilenlerden başka tüm komutları çalıştırmak isteyen kullanıcılar, "Apigee" kullanıcısına tam sudo erişimine sahip olmalıdır. Bu komutlar arasında şunlar yer alır:

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

"apigee" kullanıcısına tam sudo erişimi olan bir kullanıcı oluşturma

Bir kullanıcıyı "apigee" kullanıcısına tam sudo erişimi olacak şekilde yapılandırmak için "visudo" komutunu kullanarak sudoers dosyasını düzenleyip şunları ekleyin:

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" kullanıcısının erişebilmesi gerekir. Edge lisans dosyası ve tüm yapılandırma dosyaları buna dahildir.

Bir yapılandırma dosyası oluştururken, Edge komutlarının erişebilmesi için dosyanın sahibini "apigee:apigee" olarak değiştirebilirsiniz:

1. Dosyayı bir düzenleyicide herhangi bir kullanıcı olarak oluşturun.
2. chown dosyanın sahibini "Apigee:Apigee" olarak ayarlayın veya Edge hizmetini çalıştıran kullanıcıyı "Apigee" kullanıcısından değiştirdiyseniz dosyayı Edge hizmetini çalıştıran kullanıcıyla değiştirin.

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

Edge yükleme sürecinin tamamını root olarak veya tam sudo erişimi olan bir kullanıcı tarafından gerçekleştirmek en kolay yöntem olsa da bu her zaman mümkün değildir. Bunun yerine, işlemi root tarafından gerçekleştirilen görevler ve "apigee" kullanıcısına tam sudo erişimi olan bir kullanıcı tarafından gerçekleştirilen görevler olarak ayırabilirsiniz.

1. root tarafından gerçekleştirilen görevler:
   1. bootstrap_4.53.00.sh dosyasını indirip çalıştırın:

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

      Bu adımda apigee-service yardımcı programı yüklenir ve "apigee" kullanıcısı oluşturulur.

   2. "apigee" kullanıcısına tam sudo erişimi olan bir kullanıcı oluşturma bölümünde açıklandığı şekilde bir kullanıcıyı "apigee" kullanıcısına tam sudo erişimi olacak şekilde yapılandırın.
   3. apigee-setup yardımcı programını yükleyin:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. Edge RPM'lerini düğüme 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 RPM'leri topolojinize bağlıdır. Kullanılabilir bileşenlerin listesi: 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ı, Edge RPM'lerini düğüme yükledikten sonra "apigee" kullanıcısına tam sudo erişimi olan kullanıcı yapılandırma sürecini tamamlar:
   1. Düğümdeki Edge bileşenlerinin yapılandırmasını tamamlamak için setup.sh yardımcı programını kullanın. Komutun biçimi, düğüme yüklediğiniz bileşenlere bağlıdır. Tam liste için Edge bileşenlerini bir düğüme yükleme başlıklı makaleyi inceleyin.

      Örneğin, ZooKeeper ve Cassandra'nın kurulumunu tamamlamak için aşağıdaki komutu kullanın:

      /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, Edge yüklemesiyle ilgili bilgileri içeren bir yapılandırma dosyası göndermeniz gerekir. Sessiz yüklemelerde tek şart, yapılandırma dosyasının "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmasıdır. Örneğin, dosyayı düğümdeki /usr/local/var veya /usr/local/share dizinine ve chown "apigee:apigee"ye yerleştirin.

Edge sistem yöneticisinin şifresi hariç yapılandırma dosyasındaki tüm bilgiler gereklidir. Şifreyi atlarsanız apigee-setup yardımcı programı, şifreyi komut satırına girmenizi ister.

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

Yükleme hatasını işleme

Bir Edge bileşeninin yüklenmesi sırasında hata oluşursa sorunu düzeltmeyi deneyebilir ve ardından yükleyiciyi tekrar çalıştırabilirsiniz. Yükleyici, bir hata algıladığı durumlarda veya yükleme sonrasında bir bileşeni değiştirmek ya da güncellemek istediğinizde tekrar tekrar çalıştırılmak üzere tasarlanmıştır.

Yükledikten veya yükselttikten sonra, Edge kullanıcı arayüzü bileşenini çalıştığı her düğümde yeniden başlattığınızdan emin olun.

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

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

  Harici internet bağlantısı olmayan düğümler, Apigee deposunun dahili olarak ayarladığınız yansıtılmış bir sürümüne erişebilir. Bu depo tüm Edge RPM'lerini içerir ancak diğer tüm bağımlılıkların dahili ağdaki depolardan kullanılabildiğinden emin olmanız gerekir.

  Dahili Apigee deposunu oluşturmak için Edge RPM'lerini ve bağımlılıklarını indirebilmek amacıyla harici internet erişimi olan bir düğümün olması gerekir. Şirket içi deposu oluşturduktan sonra başka bir düğüme taşıyabilir veya bu düğümü Edge düğümleri tarafından yüklenmeye hazır hale getirebilirsiniz.

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

Yerel veya yansıtılmış bir depoyu kullanma nedenlerinden biri, önceki bölümde açıklandığı gibi Edge'i harici internet bağlantısı olmayan düğümlere yüklemektir.

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

Apigee Edge dağıtım dosyaları, her biri kendi yükleme bağımlılık zincirine sahip olabilecek bir RPM dosyası grubu olarak yüklenir. Bu bağımlılıkların çoğu, Apigee'nin kontrolü dışında olan ve dilediğiniz zaman değişebilen üçüncü taraf bileşenleri tarafından tanımlanır. Bu nedenle, belgelerde her bağımlılık için açık sürüm numarası listelenmez.

İnternet erişimi olan bir makinede yükleme gerçekleştiriyorsanız düğüm, gerekli BGBG'leri ve bağımlılıkları indirebilir. Bununla birlikte, internet erişimi olmayan bir düğümden yükleme yapıyorsanız genellikle gerekli tüm bağımlılıkları içeren dahili bir depo oluşturursunuz. Tüm bağımlılıkların yerel depoya dahil edilmesini sağlamanın tek yolu, yükleme denemesi yapmak, eksik bağımlılıklarını tespit etmek ve yükleme başarılı olana kadar bunları yerel depoya kopyalamaktır.

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. Bir düğümdeki yüklemeyi yönetmek için birkaç Yum komutu kullanmanız gerekebilir.

• Tüm Yum önbellekleri temizlenir:

  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, tüm dosyaları /opt/apigee dizinine yükler.

Bu kılavuzda ve Edge İşlem Kılavuzu'nda kök kurulum dizini şu şekilde belirtilmiştir:

/opt/apigee

Kurulum, Private Cloud için Apigee Edge'i dağıtmak amacıyla aşağıdaki dosya sistemi yapısını kullanır.

Günlük Dosyaları

apigee-setup ve setup.sh komut dosyası için günlük dosyası /tmp/setup-root.log'ye 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 şu dizinde bulunur:

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

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

Veriler

Yükleme sırasında sistem kontrolünü etkinleştirme

Edge yükleme yapılandırma dosyası aşağıdaki özelliği destekler:

ENABLE_SYSTEM_CHECK=y

Bu özelliği "y" olarak ayarlarsanız yükleyici, sistemin yüklenen bileşenin CPU ve bellek gereksinimlerini karşılayıp karşılamadığını kontrol eder. Varsayılan değer "n"dir ve kontrolü devre dışı bırakır.