Bu sayfa, Cloud Translation API ile çevrilmiştir.

Kubernetes entegrasyonu için ön koşullar

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Bu konuda, Edge Microgateway'i bir Kubernetes kümesine hizmet olarak yüklemeden önce tamamlamanız gereken adımlar açıklanmaktadır.

Bu konuda aşağıdaki konular ele alınmaktadır:

Kubernetes kümeniz için minimum gereksinimler.
Edge Mikro Ağ Geçidi'ni yükleme ve yapılandırma.
Edge Mikro Ağ Geçidi'nin temel yapılandırmasını Kubernetes kümenize yükleme.

Kubernetes kümeniz için gereksinimler

Kubernetes kümeniz için gerekenler:

Kubernetes 1.9 veya üzeri sürümler.
Kubernetes CLI kubectl v1.9 veya üzeri.
Her birinde 2 vCPU bulunan en az 3 düğüm içeren bir küme.

Örnek: Google Kubernetes Engine'de (GKE) Kubernetes kümesi oluşturma

Kubernetes yönetim makinenizi kurun

Kubernetes yönetim makinesi, Kubernetes kümenizde komut çalıştırmak için kullandığınız yerel makinenizdir. Bu makine, genellikle Kubernetes sanal makinelerinize erişimi olan bir masaüstü makinedir.

Kubernetes yönetim makinesine aşağıdaki yardımcı programları yüklemeniz gerekir:

kubectl komut satırı arayüzünün 1.9 veya sonraki bir sürümünü yükleyin.
(Yalnızca GKE) GKE'de Kubernetes çalıştırıyorsanız gcloud'u yükleyin.

GKE'de Kubernetes kümesi oluşturma

Google Cloud Platform'daki (GCP) Google Kubernetes Engine (GKE) kontrol paneline giriş yapın.
Küme Oluştur'u tıklayın.
Standart Küme'yi seçin.
Kümeniz için bir ad girin.
Bir alt bölge seçin.
Cluster Version 1.9.7-gke-* seçeneğini belirleyin. Örneğin, 1.9.7-gke.6.
3 düğüm boyutu seçin.
7,5 GB bellekli 2 vCPU seçin.
Create'i (Oluştur) tıklayın.

Aşağıdaki ekran görüntüsünde, GKE kontrol panelinin önceki adımlarda açıklandığı şekilde doldurulduğu gösterilmektedir:

Küme kimlik bilgilerinizi alma

GKE projenizin adını belirleyin:
```
gcloud config set project projectName
```
GKE proje alt bölgenizi ayarlayın:
```
gcloud config set compute/zone zoneName
```

gcloud container kimlik bilgilerinizi alın:

gcloud container clusters get-credentials cluster-name --zone zone --project project-name

Bu örnekte:

cluster-name, oluşturduğunuz Kubernetes kümesinin adıdır.
zone, kümenizin bulunduğu alt bölgedir.
project-name, GCP projenizin adıdır.

Örneğin:

gcloud container clusters get-credentials edgemicrogateway-cluster --zone us-central1-a --project edgemicro-project

Aşağıdaki komutu tam olarak gösterildiği gibi yürütün. Bu komut, geçerli kullanıcıya küme yöneticisi izinleri verir. Edge Microgateway hizmeti için gerekli RBAC kurallarını oluşturmak amacıyla yönetici izinleri gereklidir:
```
kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user=$(gcloud config get-value core/account)
```

Kubernetes için Edge Mikro Ağ Geçidi'ni yükleme

Kubernetes için Edge Mikro Ağ Geçidi'ni indirin. Bir MacOS veya Linux makinesi kullanıyorsanız, sürüm adını belirterek en son sürümü veya belirli bir sürümü indirebilirsiniz.

En son sürümü edinmek için:

curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -

Sürüm numarasına göre belirli bir sürümü almak için. Sürüm numarasının önüne "v" harfi eklenmesi gerektiğini unutmayın. Örneğin: v3.0.2

curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s  version

Örneğin:

curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s v3.0.2

Dizini microgateway_Version_OS_ARCH yükleme dizini olarak değiştirin. Örneğin:
```
cd microgateway_2.5.26_Darwin_x86_64
```
Yükleme dizinini inceleyin:
- /install/kubernetes - Kubernetes'e dağıtım için .yaml dosyalarını yapılandırma.
- /samples - Yüklemenizi test etmek için örnek uygulamalar.
- /bin - Yürütülebilir edgemicroctl dosyası. edgemicroctl komutu, Edge Mikro Ağ Geçidi'ni Kubernetes'e ekler
edgemicroctl istemcisini PATH hesabınıza ekleyin. Örneğin, bir MacOS veya Linux sisteminde aşağıdaki komutu çalıştırın:
```
export PATH=$PWD/bin:$PATH
```
Temel Edge Mikro Ağ Geçidi kurulumunu Kubernetes kümesine uygulayın. Aşağıdaki komut, edgemicro-system ad alanı ve küme rolleri oluşturur.
```
kubectl apply -f install/kubernetes/edgemicro.yaml
```
NGINX Giriş denetleyicisini kümeye yükleyin. Başka Nginix denetleyicinin çalışmadığından emin olun. kubectl get pods komutunu çalıştırarak kontrol edebilirsiniz.
```
kubectl apply -f install/kubernetes/edgemicro-nginx-gke.yaml
```
Not: Yalnızca Edge Mikro Ağ Geçidi'ni küme dışındaki tüketicilere gösteriyorsanız giriş denetleyicisi yüklemeniz gerekir. Mikro ağ geçidini harici olarak gösteriyorsanız istediğiniz herhangi bir giriş denetleyicisini kullanabilirsiniz. NGINX burada yalnızca örnek olarak kullanılmıştır.

Yüklemeyi doğrulama

Giriş denetleyicisinin başlayıp başlamadığını kontrol etmek için aşağıdaki komutu çalıştırın:

kubectl get pods --all-namespaces -l app=edgemicro-ingress --watch

Aşağıdaki örnek çıkışta gösterildiği gibi, işlemlerin başlaması bir veya iki dakika sürer. STATUS değeri Running olarak değişmeden önce birkaç Hata ve Yeniden başlatma döngüsü görmek normaldir.

NAMESPACE          NAME                                            READY     STATUS             RESTARTS   AGE
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       CrashLoopBackOff   1          33s
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       Error              2          33s
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       CrashLoopBackOff   2          40s
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       Running            3          1m
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   1/1       Running            3          1m

Giriş çalışırken yukarıdaki komutu Ctrl+C yazarak iptal edebilirsiniz.

Kubernetes hizmetlerinin dağıtıldığından emin olmak için bu komutu çalıştırın. Aşağıda gösterilen örnek çıkışa benzer bir çıkış almanız gerekir:

kubectl get svc -n edgemicro-system

Örnek çıktı:

NAME                        TYPE           CLUSTER-IP     EXTERNAL-IP    PORT(S)                     AGE
default-http-backend        ClusterIP      10.19.255.106  <none>         80/TCP                       2h
edgemicro-ingress           LoadBalancer   10.19.247.156  35.224.24.13   80:30176/TCP,443:32325/TCP   2h

Tüm kapsüllerin çalıştığını doğrulayın:

kubectl get pods -n edgemicro-system

Örnek çıktı:

NAME                                            READY     STATUS    RESTARTS   AGE
default-http-backend-55c6c69b88-2lvtw           1/1       Running   0          4m
edgemicro-ingress-controller-64444469bf-wjhrn   1/1       Running   3          4m

Edge Mikro Ağ Geçidi'ni yükleme

Cihazınızda Edge Microgateway 2.5.26 veya daha yeni bir sürüm yüklü olmalıdır. Aşağıdakileri girerek kontrol edebilirsiniz:
```
edgemicro --version
```
Edge Microgateway 2.5.26 veya sonraki bir sürümü yüklü değilse yükleme komut dosyasını yürütün:
```
npm install edgemicro -g
```
Edge Microgateway'i ilk kez kısa bir süre önce yüklediyseniz veya yükselttiyseniz şu komutu çalıştırın:
```
edgemicro init
```
Daha fazla yardıma ihtiyaç duyarsanız Edge Mikro Ağ Geçidini Yükleme başlıklı makaleye bakın.

Sonraki adım

Artık Edge Mikro Ağ Geçidi'ni Kubernetes'e dağıtmaya hazırsınız.

Edge Mikro Ağ Geçidi'ni hizmet olarak dağıtma başlıklı makaleyi inceleyin.