Kubernetes'e YAML ile kendi kendine barındırılan bir ağ geçidi dağıtma

Şunlar için geçerlidir: Geliştirici | Premium

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

Not

Ayrıca Azure Arc özellikli bir Kubernetes kümesine küme uzantısı olarak kendi barındırdığınız ağ geçidini dağıtabilirsiniz.

Önkoşullar

• Şu hızlı başlangıcı tamamlayın: Azure API Management örneği oluşturma.

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

  İ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 kullanma

• API Management örneğinizde kendi kendine barındırılan bir ağ geçidi kaynağı sağlayın.

Kubernetes’e dağıtma

İpucu

Aşağıdaki adımlar, yerel olarak barındırılan ağ geçidini Kubernetes'e dağıtır ve bir ağ geçidi erişim belirteci (kimlik doğrulama anahtarı) kullanarak API Yönetimi örneğinde kimlik doğrulamasını etkinleştirir. Kendi sunucunuzda barındırılan ağ geçidini Kubernetes'e dağıtarak ve Microsoft Entra ID'yi kullanarak API Yönetimi örneğinde kimlik doğrulamasını etkinleştirebilirsiniz.

1. Dağıtım ve altyapı altında Ağ Geçitleri'ni seçin.
2. Dağıtmak istediğiniz kendi barınan ağ geçidi kaynağını seçin.
3. Dağıtım'ı seçin.
4. Belirteç metin kutusundaki erişim belirteci, varsayılan Süre Sonu ve Gizli anahtar değerlerine göre sizin için otomatik olarak oluşturuldu. Gerekirse, yeni bir belirteç oluşturmak için denetimlerden birini veya her iki denetimdeki değerleri seçin.
5. Dağıtım betikleri altında Kubernetes sekmesini seçin.
6. <Ağ geçidi-adı>.yml dosya bağlantısını seçin ve YAML dosyasını indirin.
7. Komutları panoya simgesini seçin.
8. Azure Kubernetes Service (AKS) kullanırken yeni bir terminal oturumunda çalıştırın az aks get-credentials --resource-group <resource-group-name> --name <resource-name> --admin .
9. Komutları varsayılan ad alanında gerekli Kubernetes nesnelerini oluşturmak ve Microsoft Artifact Kayıt Defteri'nden indirilen kapsayıcı görüntüsünden kendi barındırılan ağ geçidi podlarını başlatmak için çalıştırın.
   • İlk adım, 4. adımda oluşturulan erişim belirtecini içeren bir Kubernetes gizli dizisi oluşturur. Ardından, kendi barındırılan ağ geçidi için bir Kubernetes dağıtımı oluşturur ve bu dağıtımı ağ geçidinin yapılandırmasıyla bir ConfigMap kullanarak yapılandırır.

Ağ geçidinin çalıştığını onaylayın

1. Dağıtımın başarılı olup olmadığını denetlemek için aşağıdaki komutu çalıştırın. Tüm nesnelerin oluşturulması ve podların başlatılması biraz zaman alabilir.

   kubectl get deployments
   

   Geri dönmesi gerekir

   NAME             READY   UP-TO-DATE   AVAILABLE   AGE
   <gateway-name>   1/1     1            1           18s
   

2. Hizmetlerin başarıyla oluşturulup oluşturulmadığını denetlemek için aşağıdaki komutu çalıştırın. Hizmet IP'leriniz ve bağlantı noktalarınız farklı olacaktır.

   kubectl get services
   

   Geri dönmesi gerekir

   NAME                                TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
   <gateway-name>-live-traffic         ClusterIP      None            <none>        4290/UDP,4291/UDP   9m1s
   <gateway-name>-instance-discovery   LoadBalancer   10.99.236.168   <pending>     80:31620/TCP,443:30456/TCP   9m1s
   

3. Azure portalına dönün ve Genel Bakış'ı seçin.

4. Durum'un yeşil bir onay işareti ve ardından YAML dosyasında belirtilen çoğaltma sayısıyla eşleşen bir düğüm sayısı gösterdiğini onaylayın. Bu durum, dağıtılan öz barındırılan ağ geçidi podlarının API Yönetimi hizmetiyle başarıyla iletişim kurması ve düzenli bir "kalp atışı" olduğu anlamına gelir.

İpucu

• Birden fazla pod varsa, rastgele bir poddan günlükleri görüntülemek için kubectl logs deployment/<gateway-name> komutunu çalıştırın.
• kubectl logs -h, belirli bir pod veya kapsayıcının günlüklerini görüntülemek gibi eksiksiz bir komut seçenekleri dizisi için çalıştırın.

İlgili içerik

• Şirket içinde barındırılan ağ geçidi hakkında daha fazla bilgi edinmek için bkz . Şirket içinde barındırılan ağ geçidine genel bakış.
• Azure Arc özellikli Kubernetes kümelerine API Management kendi kendine barındırılan ağ geçidini dağıtmayı öğrenin.
• Kubernetes üzerinde üretim ortamında öz barındırılan ağ geçidini çalıştırma yönergeleri hakkında daha fazla bilgi edinin.