Kubernetes entegrasyonu için ön koşullar

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

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

Bu konuda ele alınan konular:

  • Kubernetes kümeniz için minimum koşullar.
  • Edge Microgateway'i yükleme ve yapılandırma.
  • Edge Microgateway'in 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 sonraki sürümler.
  • Kubernetes CLI kubectl 1.9 veya sonraki sürümler.
  • Her biri 2 vCPU'ya sahip en az 3 düğüm içeren bir küme.

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

Kubernetes yönetim makinenizi ayarlama

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

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 kullanıyorsanız gcloud'u yükleyin.

GKE'de Kubernetes kümesi oluşturma

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

  9. Oluştur'u tıklayın.

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

    GKE kontrol paneli

Küme kimlik bilgilerinizi alma

  1. GKE proje adınızı ayarlayın:

    gcloud config set project projectName

  2. GKE projenizin bölgesini ayarlayın:

    gcloud config set compute/zone zoneName

  3. gcloud kapsayıcı 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

  4. Aşağıdaki komutu tam olarak gösterildiği gibi yürütün. Komut, mevcut kullanıcıya küme yöneticisi izinleri verir. Edge Microgateway hizmeti için gerekli RBAC kurallarını oluşturmak üzere yönetici izinleri gerekir:

    kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user=$(gcloud config get-value core/account)

Kubernetes için Edge Microgateway'i yükleme

  1. Kubernetes için Edge Microgateway'i indirin. MacOS veya Linux 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 eklenmelidir. Ö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

  2. Dizini, yükleme dizini microgateway_Version_OS_ARCH olarak değiştirin. Örneğin:

    cd microgateway_2.5.26_Darwin_x86_64

  3. Yükleme dizinini inceleyin:

    • /install/kubernetes: Kubernetes'e dağıtım için yapılandırma .yaml dosyaları.
    • /samples: Yüklemenizin test edilmesi için örnek uygulamalar.
    • /bin: edgemicroctl yürütülebilir dosyası. edgemicroctl komutu, Edge Microgateway'i Kubernetes'e ekler

  4. edgemicroctl istemcisini PATH'inize ekleyin. Örneğin, MacOS veya Linux sistemde aşağıdaki komutu çalıştırın:

    export PATH=$PWD/bin:$PATH

  5. Temel Edge Microgateway 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

  6. NGINX Giriş denetleyicisini kümeye yükleyin. Başka bir 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

Kurulumu doğrulama

  1. Giriş denetleyicisinin başlatılıp başlatılmadığı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 Running olarak değişene kadar birkaç Hata ve Yeniden Başlatma döngüsü görmeniz 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

  2. Giriş çalıştıktan sonra Ctrl+C yazarak yukarıdaki komutu iptal edebilirsiniz.

  3. Kubernetes hizmetlerinin dağıtılıp dağıtılmadığını kontrol etmek için bu komutu çalıştırın. Aşağıda gösterilen örnek çıkışa benzer bir çıkış görürsünüz:

    kubectl get svc -n edgemicro-system

    Örnek çıkış:

    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

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

    kubectl get pods -n edgemicro-system

    Örnek çıkış:

    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 Microgateway'i yükleme

  1. Edge Microgateway 2.5.26 veya daha yeni bir sürüm yüklü olmalıdır. Şunu girerek kontrol edebilirsiniz:

    edgemicro --version

  2. Edge Microgateway 2.5.26 veya sonraki bir sürümü yüklemediyseniz yükleme komut dosyasını çalıştırın:

    npm install edgemicro -g

  3. Edge Microgateway'i ilk kez yüklediyseniz veya yükselttiyseniz şu komutu çalıştırın:

    edgemicro init

    Daha fazla yardıma ihtiyacınız varsa Edge Microgateway'i yükleme başlıklı makaleyi inceleyin.

Sonraki adım

Artık Edge Microgateway'i Kubernetes'e dağıtmaya hazırsınız.