Tipik bir Edge kurulumu, birden fazla düğüme dağıtılan Edge bileşenlerinden oluşur. Bir düğüme Edge yükledikten sonra, düğüme bir veya daha fazla Edge bileşeni yükleyip yapılandırırsınız.
Yükleme işlemi
Bir düğüme Edge yükleme işlemi çok adımlı bir işlemdir:
- 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 bölümüne bakın.
- Cassandra kimlik doğrulamasını etkinleştirmek isteyip istemediğinize karar verin.
- Postgres için ana bekleme modunda çoğaltma 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üne bakın.
- Seçtiğiniz topolojideki her düğüme Edge
apigee-setup
yardımcı programını yükleyin:- Edge
bootstrap_4.52.01.sh
dosyasını/tmp/bootstrap_4.52.01.sh
hedefine 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 bölümüne bakın.
- Edge
- 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üğüme Edge bileşenlerini yükleme konusuna bakın.
- Yönetim Sunucusu düğümünde, Edge kuruluşlarını oluşturmak ve yönetmek için kullandığınız
apigee-provision
yardımcı programlarını yüklemek içinapigee-setup
yardımcı programını kullanın.Daha fazla bilgi için Kuruluşa ilk katılım başlıklı makaleyi inceleyin.
- Yükleme tamamlandıktan sonra her düğümde Klasik Kullanıcı Arayüzü bileşenini yeniden başlatın. Bunun için aşağıdaki örnekte gösterildiği gibi:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
(Önerilir) İlk yüklemeyi tamamlamanızın ardından Apigee, Private Cloud için Apigee Edge geliştiricilerinin ve yöneticilerinin gelişmiş 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ı makaleye bakın.
Yükleme tamamlandıktan sonra sık kullanılan yükleme sonrası işlemler listesine göz atın.
Yüklemeyi kimler gerçekleştirebilir?
Apigee Edge dağıtım dosyaları, bir BGBG ve bağımlılık grubu 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 için bu, 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 root 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
.
- Apigee-service komutları:
- Edge bileşenlerini yüklemek için setup.sh komut dosyasını kullanın (Gerekli BGBG'leri yüklemek için halihazırda "
apigee-service install
" kullanmadıysanız). 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" adlı yeni bir kullanıcı oluşturur. Birçok Edge komutu, "Apigee" kullanıcısı olarak çalışmak için sudo'yu çağırır.
Yukarıda gösterilenlerin dışındaki tüm komutları çalıştırmak isteyen kullanıcılar, "Apigee" kullanıcısına tam sudo erişimi olan bir kullanıcı olmalıdır. Bu komutlar şunları içerir:
-
Aşağıdakiler dahil Apigee-service yardımcı programı komutları:
start, stop, restart, configure
gibi Apigee-service komutları.start, stop, restart, configure
gibi Apigee-all komutları kullanın.
"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şimine sahip olacak şekilde yapılandırmak için "visudo" komutunu kullanarak sudoers dosyasını düzenleyerek 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ının kullandığı tüm dosyalara 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.
Bir yapılandırma dosyası oluştururken, Edge komutları tarafından erişilebildiğinden emin olmak için dosyanın sahibini "Apigee:Apigee" olarak değiştirebilirsiniz:
- Dosyayı bir düzenleyicide herhangi bir kullanıcı olarak oluşturun.
chown
Dosyanın sahibi "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 göre chown işlemi yapın.
Edge yükleme görevlerini kök ve kök olmayan kullanıcılar 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 değildir. Bunun yerine, işlemi kök tarafından ve "Apigee" kullanıcısına tam sudo erişimine sahip bir kullanıcı tarafından gerçekleştirilen görevlere ayırabilirsiniz.
- Kök tarafından gerçekleştirilen görevler:
bootstrap_4.52.01.sh
dosyasını indirip çalıştırın:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
Bu adım,
apigee-service
yardımcı programını yükler ve "Apigee" kullanıcısını oluşturur.- Bir kullanıcıyı, "Apigee" kullanıcısına tam sudo erişimi olan bir kullanıcı oluşturma bölümünde açıklandığı şekilde "Apigee" kullanıcısına tam sudo erişimine sahip olacak şekilde yapılandırın.
apigee-setup
yardımcı programını yükleyin:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Düğüme Edge BGBG'leri yüklemek için
apigee-setup
yardımcı programını kullanın:/opt/apigee/apigee-service/bin/apigee-service compName install
Düğüme yükleyeceğiniz Edge BGBG'leri topolojinize bağlıdır. Mevcut 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
.
- Kök kullanıcı düğüme Edge BGBG'lerini yükledikten sonra, "Apigee" kullanıcısına tam sudo erişimi olan kullanıcı yapılandırma işlemini tamamlar:
- 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 sayfasına bakın.Örneğin, ZooKeeper ve Cassandra'nın yüklenmesini 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 yapmak için aşağıdaki komutu da kullanabilirsiniz:
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
- Düğümdeki Edge bileşenlerinin yapılandırmasını tamamlamak için
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üklemelerde tek şart, yapılandırma dosyasının "Apigee" kullanıcısı tarafından erişilebilir veya okunabilmesidir. Örneğin, dosyayı düğümdeki /usr/local/var
veya /usr/local/share
dizinine yerleştirin ve dosyayı "Apigee:apigee" öğesine chown
ekleyin.
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 konusuna bakın.
Yükleme hatasını işleme
Bir Edge bileşeninin yüklenmesi sırasında hata oluşması durumunda, sorunu gidermeyi ve ardından yükleyiciyi tekrar çalıştırmayı deneyebilirsiniz. Yükleyici, bir hata algıladığında veya kurulumdan sonra bir bileşeni değiştirmek ya da güncellemek istediğinizde tekrar tekrar çalışacak şekilde tasarlanmıştır.
Yükleme veya yükseltme işleminden sonra, üzerinde çalıştığı her düğümde Edge kullanıcı arayüzü bileşenini yeniden başlattığınızdan emin olun.
İnternet kurulumu veya İnternet dışı yükleme
Bir düğüme Edge 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 BGBG'leri 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 kurduğunuz yansıtılmış bir sürümüne erişebilir. Bu depo, tüm Edge BGBG'lerini içerir ancak diğer tüm bağımlılıkların dahili ağdaki kod depolarında bulunduğundan emin olmanız gerekir.
Dahili Apigee deposunu oluşturmak istiyorsanız Edge BGBG'lerini ve bağımlılıklarını indirmek için harici internet erişimi olan bir düğüme ihtiyacınız vardır. Dahili depoyu oluşturduktan sonra bu düğümü başka bir düğüme taşıyabilir veya yükleme için Edge düğümleri tarafından erişilebilir hale getirebilirsiniz.
Edge sürümünüzü korumak için yerel bir Edge deposunu kullanma
Yerel veya yansıtılmış depo kullanmanın nedenlerinden biri, bir önceki bölümde açıklandığı gibi Edge'in harici internet bağlantısı olmayan düğümlere yüklenmesidir.
BGBG yükleme bağımlılıklarını çözme
Apigee Edge dağıtım dosyaları, her birinin kendi yükleme bağımlılıkları zinciri olabilecek bir BGBG dosyaları grubu olarak yüklenir. Bu bağımlılıkların çoğu, Apigee'nin kontrolü dışındaki üçüncü taraf bileşenler tarafından tanımlanır ve herhangi bir zamanda değiştirilebilir. Bu nedenle, belgelerde her bağımlılığın 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. 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 edilmesini garanti etmenin tek yolu, yükleme yapmaya çalışmak, eksik bağımlılıkları tespit etmek ve bunları, kurulum işlemi başarılı olana kadar yerel depoya kopyalamaktır.
Genel 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
- 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 Uç İşlemleri Kılavuzu'nda kök yükleme dizini şu şekilde belirtilmiştir:
/opt/apigee
Yükleme işleminde, Private Cloud için Apigee Edge'in dağıtılması amacıyla aşağıdaki dosya sistemi yapısı kullanılır.
Günlük Dosyaları
apigee-setup
için günlük dosyası ve setup.sh
komut dosyası, /tmp/setup-root.log
üzerine 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 dizindedir:
/opt/apigee/var/log/edge-management-server
Aşağıdaki tablolarda günlük dosyalarının konumu listelenmiştir:
Bileşen | Konum |
---|---|
Yönetim Sunucusu |
/opt/apigee/var/log/edge-management-server
|
Yönlendirici |
/opt/apigee/var/log/edge-router
Uç Yönlendirici, Nginx kullanılarak uygulanır. Ek günlükler için bkz.
|
Mesaj İşleyici |
/opt/apigee/var/log/edge-message-processor
|
Apigee Qpid Sunucusu |
/opt/apigee/var/log/edge-qpid-server
|
Apigee Postgres Sunucusu | /opt/apigee/var/log/edge-postgres-server |
Klasik kullanıcı arayüzü (bileşen adı edge-management-ui olan yeni Edge kullanıcı arayüzü değil) |
/opt/apigee/var/log/edge-ui |
ZooKeeper | /opt/apigee/var/log/apigee-zookeeper |
OpenLDAP | /opt/apigee/var/log/apigee-openldap |
Cassandra | /opt/apigee/var/log/apigee-cassandra/system.log |
Qpidd | /opt/apigee/var/log/apigee-qpidd |
PostgreSQL veritabanı | /opt/apigee/var/log/apigee-postgresql |
apigee-monit |
/opt/apigee/var/log/apigee-monit |
Veriler
Bileşen | Konum |
---|---|
Yönetim Sunucusu | /opt/apigee/data/edge-management-server |
Yönlendirici | /opt/apigee/data/edge-router |
Mesaj İşleyici | /opt/apigee/data/edge-message-processor |
Apigee Qpid aracısı | /opt/apigee/data/edge-qpid-server |
Apigee Postgres aracısı | /opt/apigee/data/edge-postgres-server |
ZooKeeper | /opt/apigee/data/apigee-zookeeper |
OpenLDAP | /opt/apigee/data/apigee-openldap |
Cassandra | /opt/apigee/data/apigee-cassandra/data |
Qpidd | /opt/apigee/data/apigee-qpid/data |
PostgreSQL veritabanı | /opt/apigee/data/apigee-postgres/pgdata |
apigee-monit |
/opt/apigee/data/apigee-monit |
Yüklemede sistem kontrolünü etkinleştir
Edge yükleme yapılandırma dosyası şu ö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. Kontrolü devre dışı bırakmak için varsayılan değer "n"dir.