Helm ile Kubernetes'e dağıtma

Helm , Kubernetes uygulamalarının yaşam döngüsünü yüklemenize ve yönetmenize yardımcı olan bir açık kaynak paketleme aracıdır. Önceden yapılandırılmış Kubernetes kaynaklarının paketleri olan Kubernetes grafiklerini yönetmenizi sağlar.

Bu makalede, Helm kullanarak Azure API Management'nin şirket içinde barındırılan ağ geçidi bileşenini Kubernetes kümesine dağıtma adımları sağlanır.

Önemli

Azure API Management şirket içi barındırılan ağ geçidi sürüm 0 ve sürüm 1 kapsayıcı görüntüleri desteği, karşılık gelen Yapılandırma API'si v1 ile birlikte 1 Ekim 2023'te sona eriyor. Configuration API v2 ile şirket içi barındırılan ağ geçidi v2.0.0 veya üzerini kullanmak için geçiş kılavuzumuzu kullanın. Kullanımdan kaldırma belgelerimizde daha fazla bilgi edinin

Not

Şirket içinde barındırılan ağ geçidini Azure Arc özellikli kubernetes kümesineküme uzantısı olarak da dağıtabilirsiniz.

Kullanılabilirlik

Önemli

Bu özellik, API Management Premium ve Geliştirici katmanlarında kullanılabilir.

Önkoşullar

  • Bir Kubernetes kümesi oluşturun veya var olan bir kümeye erişin.

    İpucu

    Tek düğümlü kümeler geliştirme ve değerlendirme amacıyla iyi çalışır. Üretim iş yükleri için şirket içinde veya bulutta Kubernetes Sertifikalı çok düğümlü kümeleri kullanın.

Helm deposunu ekleme

  1. Azure API Management'ı yeni bir Helm deposu olarak ekleyin.

    helm repo add azure-apim-gateway https://azure.github.io/api-management-self-hosted-gateway/helm-charts/
    
  2. En son Helm grafiklerini getirmek için depoyu güncelleştirin.

    helm repo update
    
  3. Kullanılabilir tüm grafikleri listeleyerek Helm yapılandırmanızı doğrulayın.

    $ helm search repo azure-apim-gateway
    NAME                                            CHART VERSION   APP VERSION     DESCRIPTION
    azure-apim-gateway/azure-api-management-gateway 1.0.0           2.0.0           A Helm chart to deploy an Azure API Management ...
    

Şirket içi barındırılan ağ geçidini Kubernetes'e dağıtma

  1. Dağıtım ve altyapı bölümünden Ağ Geçitleri'ni seçin.

  2. Dağıtmak istediğiniz şirket içi barındırılan ağ geçidi kaynağını seçin.

  3. Dağıtım'ı seçin.

  4. Belirteç metin kutusundaki yeni belirteç, varsayılan Süre Sonu ve Gizli Anahtar değerleri kullanılarak sizin için otomatik olarak oluşturuldu. İsterseniz ya da her ikisini de ayarlayın ve oluştur'u seçerek yeni bir belirteç oluşturun.

  5. Belirteç ve Yapılandırma URL'nizi not alın

  6. Helm grafiğini kullanarak şirket içi barındırılan ağ geçidini yükleme

    helm install azure-api-management-gateway \
                 --set gateway.configuration.uri='<your configuration url>' \
                 --set gateway.auth.key='<your token>' \
                 azure-apim-gateway/azure-api-management-gateway
    
  7. Komutu yürütün. komutu Kubernetes kümenize şunu söyler:

    • Microsoft Container Registry'den şirket içinde barındırılan ağ geçidinin görüntüsünü indirin ve kapsayıcı olarak çalıştırın.
    • Kapsayıcıyı HTTP (8080) ve HTTPS (8081) bağlantı noktalarını kullanıma çıkaracak şekilde yapılandırın.

    Önemli

    Varsayılan olarak, ağ geçidi bir ClusterIP hizmeti kullanır ve yalnızca küme içinde kullanıma sunulur. Yükleme sırasında Kubernetes hizmetinin türünü belirterek bunu değiştirebilirsiniz.

    Örneğin, bir yük dengeleyici aracılığıyla ekleyerek bunu kullanıma sunarak --set service.type=LoadBalancer

  8. Ağ geçidi podunun çalıştığını denetlemek için aşağıdaki komutu çalıştırın. Pod adınız farklı olacaktır.

    kubectl get pods
    NAME                                           READY     STATUS    RESTARTS   AGE
    azure-api-management-gateway-59f5fb94c-s9stz   1/1       Running   0          1m
    
  9. Ağ geçidi hizmetinin çalıştığını denetlemek için aşağıdaki komutu çalıştırın. Hizmet adınız ve IP adresleriniz farklı olacaktır.

    kubectl get services
    NAME                           TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)               AGE
    azure-api-management-gateway   ClusterIP   10.0.229.55     <none>        8080/TCP,8081/TCP     1m
    
  10. Azure portal dönün ve dağıttığınız ağ geçidi düğümlerinin iyi durumda olduğunu bildirdiğini onaylayın.

İpucu

Şirket içinde barındırılan ağ geçidi günlüğünün anlık görüntüsünü görüntülemek için komutunu kullanın kubectl logs <gateway-pod-name> .

Sonraki adımlar