Edge Kurulumuna Genel Bakış

Edge for Private Cloud sürüm 4.17.05

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

Yükleme süreci

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

• Düğümde SELinux'u devre dışı bırakın veya izin verilenler moduna ayarlayın. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.
• Cassandra kimlik doğrulamasını etkinleştirmek isteyip istemediğinize karar verin.
• Postgres için ana-yedek replikasyonu 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ünü inceleyin.
• Seçtiğiniz topolojideki her düğüme Edge apigee-setup yardımcı programını yükleyin:
  • Edge bootstrap_4.17.05.sh dosyasını /tmp/bootstrap_4.17.05.sh dizinine 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.
• 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.
  Düğümde Edge bileşenlerini düğüme yükleme başlıklı makaleyi inceleyin.
• Yönetim Sunucusu düğümünde, Edge kuruluşlarını oluşturmak ve yönetmek için kullandığınız yardımcı programlar olan apigee-provision'ı yüklemek üzere apigee-setup yardımcı programını kullanın.
  Daha fazla bilgi için Kuruluşun ilk katılımını gerçekleştirme başlıklı makaleyi inceleyin.

Yükleme işlemini 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 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 tüm kullanıcıların root olması veya tam sudo erişimine sahip bir kullanıcı 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 "apigee-service install" komutunu kullanmadıysanız. Gerekli değilse 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ırılmak 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ı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 dosya veya kaynaklara "apigee" kullanıcısı erişebilmelidir. Edge lisans dosyası ve tüm yapılandırma dosyaları buna dahildir.

Yapılandırma dosyası oluştururken, Edge komutları tarafından erişilebilir olmasını 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. 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 dosyayı Edge hizmetini çalıştıran kullanıcıya 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 işleminin tamamını kök olarak veya tam sudo erişimine sahip bir kullanıcı tarafından gerçekleştirmek en basit yöntem olsa da bu her zaman mümkün olmayabilir. 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. Kök tarafından gerçekleştirilen görevler:
   1. bootstrap_4.17.05.sh dosyasını indirip çalıştırın:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
      
      Bu adımda apigee-service yardımcı programı yüklenir ve "apigee" kullanıcısı oluşturulur.
   2. Bir kullanıcıyı, yukarıda açıklandığı gibi "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üğümde 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-ui, 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ı, düğüme Edge RPM'lerini yükledikten sonra "apigee" kullanıcısına tam sudo erişimi olan kullanıcı, yapılandırma işlemini 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 Düğüme Edge bileşenlerini yükleme başlıklı makaleyi inceleyin.
      Örneğin, ZooKeeper ve Cassandra'nın yükleme işlemini 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, hepsi bir arada 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 kurulumuyla ilgili bilgileri içeren bir yapılandırma dosyası iletmeniz gerekir. Sessiz yüklemelerle ilgili 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 yerleştirin ve "apigee:apigee" olarak değiş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 Bir düğüme Edge bileşenlerini 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, 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.

İnternet üzerinden veya internet olmadan 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, dahili olarak ayarladığınız Apigee deposunun 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 depolarda bulunduğundan 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üğüme ihtiyacınız vardır. Dahili depoyu oluşturduktan sonra başka bir düğüme taşıyabilir veya bu düğümü yükleme için Edge düğümlerinin erişimine açabilirsiniz.

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 Edge'i harici internet bağlantısı olmayan düğümlere yüklemektir.

Ancak harici internet bağlantısı olan düğümler için bile yerel depo kullanmanın başka bir avantajı vardır. Edge'i Apigee herkese açık deposundan yüklediğinizde her zaman en son Edge RPM'lerini yüklersiniz. Bu nedenle, Edge'in belirli bir sürümü için Edge RPM'lerini indirip depolamak istiyorsanız bu Edge sürümü için yerel bir depo oluşturmanız gerekir. Ardından, Edge'in herhangi bir sürümünü yüklemek için bu yerel depoyu kullanabilirsiniz.

Örneğin, önce Edge geliştirme ortamı yüklemek için yerel depoyu kullanırsınız. Ardından, üretim ortamına geçmeye hazır olduğunuzda Edge'i yerel depodan tekrar yüklersiniz. Yerel depodan yükleme yaparak geliştirme ve üretim ortamlarınızın eşleştiğinden emin olursunuz.

Yansıtılmış depolar oldukça esnektir. Örneğin, en son Edge RPM'lerinden veya Edge'in belirli bir sürümünden yansıtılmış bir depo oluşturabilirsiniz. Depoyu oluşturduktan sonra, farklı Edge sürümlerinden RPM'ler eklemek için depoyu güncelleyebilirsiniz. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.

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 her an 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 makinede kurulum 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 dahili bir depo oluşturursunuz. Tüm bağımlılıkların yerel deponuza dahil edildiğinden emin olmanın tek yolu, yükleme yapmayı 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 birkaç Yum komutu kullanmanız gerekebilir.

• Tüm Yum önbelleklerini temizleyin:
  sudo yum clean all
• 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 İşlemleri Kılavuzu'nda kök yükleme dizini şu şekilde belirtilmiştir:

/opt/apigee

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

Günlük Dosyaları

apigee-setup ve setup.sh komut dosyasının günlük dosyası /tmp/setup-root.log dosyasına 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 dizindedir:

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

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

Veriler

Yükleme sonrası görevler

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

Yükleme sonrasında Edge bileşenlerini yapılandırma

Yükleme işleminden sonra Edge'i yapılandırmak için .properties dosyalarını ve Edge yardımcı programlarını birlikte kullanırsınız. Örneğin, Edge kullanıcı arayüzünde TLS/SSL'yi yapılandırmak için .properties dosyalarını düzenleyerek gerekli özellikleri ayarlarsınız. .properties dosyalarında yapılan değişiklikler, etkilenen Edge bileşenini yeniden başlatmanızı gerektirir.

.properties dosyaları /opt/apigee/customer/application dizininde bulunur. Her bileşenin bu dizinde kendi .properties dosyası vardır. Örneğin, router.properties ve management-server.properties.

Bir bileşenin özelliğini ayarlamak için ilgili .properties dosyasını düzenleyin ve ardından bileşeni yeniden başlatın:

> /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 /opt/apigee/customer/application dizinindeki .properties dosyaları okunur. Bu, güncellemenin bileşende ayarladığınız tüm özellikleri koruduğu anlamına gelir.

Edge yapılandırması hakkında daha fazla bilgi için Edge'i Yapılandırma başlıklı makaleyi inceleyin.

Edge bileşenlerinde komutları çağırma

Edge, Edge kurulumunu yönetmek için kullanabileceğiniz yönetim yardımcı programlarını /opt/apigee/apigee-service/bin dizinine yükler. Örneğin, düğümdeki tüm Edge bileşenlerini başlatmak, durdurmak, yeniden başlatmak veya durumunu belirlemek için apigee-all yardımcı programını kullanabilirsiniz:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Bileşenleri tek tek kontrol etmek ve yapılandırmak için apigee-service yardımcı programını kullanın. apigee-service yardımcı programı şu biçimdedir:

/opt/apigee/apigee-service/bin/apigee-service component action

Örneğin, Edge Router'ı yeniden başlatmak için:

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

/opt/apigee dizinini inceleyerek düğüme yüklenen bileşenlerin listesini belirleyebilirsiniz. Bu dizin, düğüme yüklenen her Edge bileşeni için bir alt dizin içerir. Her alt dizinin önünde şu ek bulunur:

• apigee: Edge tarafından kullanılan üçüncü taraf bileşeni. Örneğin, apigee-cassandra.
• edge: Apigee'den bir Edge bileşeni. Örneğin, edge-management-server.
• edge-mint: Para kazanma bileşeni. Örneğin, edge-mint-management-server.
• baas: API BaaS bileşeni. Örneğin, baas-usergrid.

Bir bileşenin işlemlerinin tam listesi bileşenin kendisine bağlıdır ancak tüm bileşenler aşağıdaki işlemleri destekler:

• start, stop, restart
• status, version
• yedekleme, geri yükleme
• install, uninstall