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 düğüme bir veya daha fazla Edge bileşeni yükleyip yapılandırırsınız.
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 bölümüne bakın.
- Cassandra kimlik doğrulamasını etkinleştirmek isteyip istemediğinize karar verin.
- Postgres için ana bekleme replikası 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.02.sh
dosyasını/tmp/bootstrap_4.52.02.sh
hedefine 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 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.Edge bileşenlerini bir düğüme yükleme başlıklı makaleye bakın.
- 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ızapigee-provision
yardımcı programlarını yükleyin.Daha fazla bilgi için Kuruluşa ilk katılım bölümünü inceleyin.
- 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
(Önerilir) İlk kurulumu tamamladıktan sonra Apigee, yeni Edge kullanıcı arayüzünü (bileşen adı
edge-management-ui
) yüklemenizi önerir. Bu kullanıcı arayüzü, Private Cloud için Apigee Edge'in geliştiricileri ve yöneticileri için geliştirilmiş bir kullanıcı arayüzüdür.Daha fazla bilgi için Yeni Edge kullanıcı arayüzünü yükleme bölümüne bakın.
Yükleme tamamlandıktan sonra sık kullanılan yükleme sonrası işlemler listesine göz atı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. 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 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
.
- Apigee-service komutları:
- Edge bileşenlerini yüklemek için setup.sh komut dosyası (gerekli BGBG'leri yüklemek üzere "
apigee-service install
" kullanmadıysanız: Daha sonra, gerekirse kök veya tam sudo erişimi sağlayın.) - 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 komutunu ç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 şunlardır:
-
Aşağıdakiler dahil olmak üzere Apigee-service yardımcı programı komutları:
- Apigee-service komutları (
start, stop, restart, configure
gibi). - Apigee-all komutları (ör.
start, stop, restart, configure
)
- Apigee-service 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şimine sahip olmasını sağlamak için "visudo" komutunu kullanarak sudoers dosyasını şu şekilde düzenleyin:
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
"Apigee" kullanıcısı, Edge komutları tarafından kullanılan tüm dosyalara veya kaynaklara erişebilmelidir. Bu, Edge lisans dosyasını ve tüm yapılandırma dosyalarını içerir.
Bir yapılandırma dosyası oluştururken, Edge komutlarının erişimine açık olmasını sağlamak için dosya sahibini "Apigee:Apigee" olarak değiştirebilirsiniz:
- Dosyayı bir düzenleyicide herhangi bir kullanıcı olarak oluşturun.
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 ve kök olmayan kullanıcı arasında ayırma
Edge yükleme işleminin tamamını root 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 kök tarafından gerçekleştirilen görevlere ve "Apigee" kullanıcısına tam sudo erişimi olan bir kullanıcı tarafından gerçekleştirilen görevlere ayırabilirsiniz.
- Kök tarafından gerçekleştirilen görevler:
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ım,
apigee-service
yardımcı programını yükler ve "Apigee" kullanıcısını oluşturur.- "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ıyı "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
- Uç BGBG'leri 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 BGBG'leri topolojinize bağlıdır. Kullanılabilir bileşenlerin listesi şunlardır:
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 Uç 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 bölümüne 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 gerçekleştirmek için aşağıdaki komutu kullanın:
/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üklemelerdeki tek şart, yapılandırma dosyasının "Apigee" kullanıcısı tarafından erişilebilir veya okunabilir olması gerektiğidir. Örneğin, dosyayı düğümdeki /usr/local/var
veya /usr/local/share
dizinine yerleştirin ve "Apigee:Apigee" konumuna chown
ekleyin.
Edge sistem yöneticisinin şifresi hariç yapılandırma dosyasındaki tüm bilgiler gereklidir. Şifreyi çıkarırsanı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ı makaleye bakın.
Yükleme hatasını işleme
Edge bileşeni kurulurken hata oluşursa sorunu düzeltmeyi deneyebilir, daha sonra yükleyiciyi tekrar çalıştırabilirsiniz. Yükleyici, bir hata algıladığında veya yükleme sonrasında bir bileşeni daha sonra 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.
İ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 BGBG'lerini ve bağımlıları 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 BGBG'lerini içerir ancak dahili ağdaki kod depolarında bulunan diğer tüm bağımlılıkların bulunduğundan emin olmanız gerekir.
Dahili Apigee deposu oluşturmak istiyorsanız Edge BGBG'lerini ve bağımlılıklarını indirebilmek için 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 Edge deposu kullanma
Yerel veya yansıtılmış depo kullanmanın nedenlerinden biri de, önceki bölümde açıklandığı üzere harici internet bağlantısı olmayan düğümlere Edge'in yüklenmesidir.
BGBG yükleme bağımlılıklarını çözme
Apigee Edge dağıtım dosyaları bir BGBG dosyası grubu olarak yüklenir. Bu dosyaların her birinin kendi yükleme bağımlılıkları zinciri olabilir. Bu bağımlılıkların çoğu, Apigee'nin kontrolü dışında olan ve her an değişebilen üçüncü taraf bileşenleriyle tanımlanır. 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üklemeyi denemek, eksik bağımlılıkları tespit etmek ve yükleme işlemi 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
- 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 İşlem Kılavuzu'nda kök yükleme dizini şu şekilde belirtilmiştir:
/opt/apigee
Kurulumda, Private Cloud için Apigee Edge'in dağıtımı sırasında aşağıdaki dosya sistemi yapısı kullanılır.
Günlük Dosyaları
apigee-setup
ve setup.sh
komut dosyası için günlük 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 dizinde bulunur:
/opt/apigee/var/log/edge-management-server
Aşağıdaki tablolarda, günlük dosyalarının konumları 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 aşağıdaki konulara göz atın:
|
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ükleme sırasında 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üklenmekte olan bileşen için 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.