Edge Kurulumuna Genel Bakış

Tipik bir Edge yüklemesi, birden fazla düğüme dağıtılmış 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ırabilirsiniz.

Yükleme süreci

Bir düğüme Edge'i 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 birincil-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ünü inceleyin.
5. Seçtiğiniz topolojideki her düğüme Edge apigee-setup yardımcı programını yükleyin:
   • Edge bootstrap_4.52.02.sh dosyasını /tmp/bootstrap_4.52.02.sh konumuna indirin.
   • 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.

     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.

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

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

   Daha fazla bilgi için Kuruluş ekleme başlıklı makaleyi inceleyin.

8. Kurulum tamamlandıktan sonra her düğümde Klasik kullanıcı arayüzü bileşenini yeniden başlatın. Aşağıdaki örnekte bu işlem gösterilmektedir:

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

9. (Önerilir) İlk yüklemeyi tamamladıktan sonra Apigee, Apigee Edge Private Cloud'un geliştiricileri ve yöneticileri için 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 yükleme sonrası yaygın işlemlerin yer aldığı bu listeye 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 RPM'lerini yüklemek, kaldırmak ve güncellemek için komutların kök kullanıcı veya tam sudo erişimi olan bir kullanıcı tarafından çalıştırılması gerekir. Tam sudo erişimi, kullanıcının kök kullanıcıyla 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 tüm kullanıcılar ya root olmalı ya da tam sudo erişimine sahip bir kullanıcı olmalıdır:

• 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 "apigee-service install" komutunu daha önce kullanmadıysanız). Ardından, gerekmiyorsa 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" adlı 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österilenler dışındaki tüm komutları çalıştırmak isteyen kullanıcıların, "apigee" kullanıcısına tam sudo erişimi olan bir kullanıcı olması gerekir. Bu komutlar şunlardır:

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

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

Bir kullanıcının "apigee" kullanıcısına tam sudo erişimi olacak şekilde yapılandırmak için "visudo" komutunu kullanarak sudoers dosyasını düzenleyin ve ş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 dosya veya kaynaklara "apigee" kullanıcısı tarafından erişilebilmelidir. Bu, Edge lisans dosyasını ve tüm yapılandırma dosyalarını içerir.

Yapılandırma dosyası oluştururken, Edge komutları tarafından erişilebilmesini sağlamak için dosyanın sahibini "apigee:apigee" olarak değiştirebilirsiniz:

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

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

Edge'in yükleme işleminin tamamını kök 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 olmayabilir. Bunun yerine, işlemi kök 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. Kök kullanıcı tarafından gerçekleştirilen görevler:
   1. bootstrap_4.52.02.sh dosyasını indirip çalıştırın:

      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
      sudo bash /tmp/bootstrap_4.52.02.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ığı gibi, bir kullanıcının "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. Düğüme Edge RPM'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 RPM'leri, topolojinize bağlıdır. Kullanılabilir bileşenlerin listesi şunları içerir: 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 Bir düğüme Edge bileşenlerini yükleme başlıklı makaleye bakın.

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

      Alternatif olarak, tek bir komutla yükleme yapmak 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ı iletmeniz gerekir. Sessiz yüklemelerle ilgili tek koşul, yapılandırma dosyasına "apigee" kullanıcısı tarafından erişilebilmesi veya dosyanın okunabilmesidir. Örneğin, dosyayı düğümdeki /usr/local/var veya /usr/local/share dizinine yerleştirin ve chown komutunu kullanarak "apigee:apigee" olarak ayarlayın.

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

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

Yükleme hatasını giderme

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 işleminden sonra bir bileşeni değiştirmek ya da güncellemek istediğinizde tekrar tekrar çalıştırılacak şekilde tasarlanmıştır.

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

İnternet bağlantısı olan veya olmayan yükleme

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ını 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ış sürümüne erişebilir. Bu depoda tüm Edge RPM'leri bulunur ancak dahili ağdaki depolarda diğer tüm bağımlılıkların mevcut olduğundan emin olmanız gerekir.

  Dahili Apigee deposunu oluşturmak için Edge RPM'lerini ve bağımlılıklarını indirebilmek üzere harici internet erişimi olan bir düğüme ihtiyacınız vardır. Dahili depoyu oluşturduktan sonra başka bir düğüme taşıyabilir veya kurulum için bu düğüme Edge düğümlerinden erişilmesini sağlayabilirsiniz.

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

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

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

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

İnternet erişimi olan bir makineye yükleme yapıyorsanız düğüm, gerekli RPM'leri ve bağımlılıkları indirebilir. Ancak internet erişimi olmayan bir düğümden yükleme yapıyorsanız genellikle gerekli tüm bağımlılıkları içeren bir dahili depo oluşturursunuz. Tüm bağımlılıkların yerel depoya dahil edildiğini garanti etmenin tek yolu, yüklemeyi denemek, eksik bağımlılıkları belirlemek 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 çeşitli Yum komutlarını kullanmanız gerekebilir.

• Tüm Yum önbelleklerini temizleme:

  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 Operations Guide'da kök yükleme dizini şu şekilde belirtilir:

/opt/apigee

Yükleme, Apigee Edge Private Cloud'u dağıtmak için aşağıdaki dosya sistemi yapısını kullanır.

Günlük Dosyaları

apigee-setup için günlük dosyası ve setup.sh komut dosyası /tmp/setup-root.log konumuna yazılır.

Her bileşenin günlük dosyaları /opt/apigee/var/log dizininde yer alır. Her bileşenin kendi alt dizini vardır. Örneğin, yönetim sunucusunun günlükleri şu dizinde bulunur:

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

Aşağıdaki tabloda 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, kontrolü devre dışı bırakmak için "n"dir.