VMware Tanzu için API portalını kullanma

Bu makale şunlar için geçerlidir:❌ Temel/Standart ✔️ Kurumsal

Bu makalede, Azure Spring Apps Kurumsal planıyla VMware Tanzu için API portalını nasıl kullanacağınız gösterilmektedir.

API portalı , ticari VMware Tanzu bileşenlerinden biridir. API portalı, VMware Tanzu için Spring Cloud Gateway'den API tanımlarının görüntülenmesini ve tarayıcıdan belirli API yollarının testini destekler. Ayrıca yapılandırma aracılığıyla çoklu oturum açma (SSO) kimlik doğrulamasını etkinleştirmeyi de destekler.

Önkoşullar

• API portalının etkinleştirildiği, önceden sağlanmış bir Azure Spring Apps Kurumsal plan örneği. Daha fazla bilgi için bkz . Hızlı Başlangıç: Kurumsal planı kullanarak uygulamaları derleme ve Azure Spring Apps'e dağıtma.
• Tanzu için Spring Cloud Gateway sağlama sırasında etkinleştirilir ve buna karşılık gelen API meta verileri yapılandırılır.

Çoklu oturum açmayı (SSO) yapılandırma

API portalı, OpenID Connect Bulma protokolunu destekleyen bir OpenID kimlik sağlayıcısı (IdP) ile çoklu oturum açma (SSO) kullanarak kimlik doğrulamasını ve yetkilendirmeyi destekler.

Microsoft Entra Id ile SSO ayarlamak için bkz . Spring Cloud Gateway için Microsoft Entra Id ve Tanzu için API Portalı ile çoklu oturum açma ayarlama.

Örnek sayısını yapılandırma

az spring api-portal update --instance-count <number>

API portalı için genel uç nokta atama

az spring api-portal update --assign-endpoint

API deneme özelliğini yapılandırma

API portalı API'leri merkezi olarak görüntülemenizi ve API deneme özelliğini kullanarak denemenizi sağlar. API denemesi varsayılan olarak etkindir ve bu yapılandırma tüm API portalı örneğinde kapatmanıza yardımcı olur. Daha fazla bilgi için API portalında API'leri deneme bölümüne bakın.

az spring api-portal update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --enable-api-try-out

az spring api-portal update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --enable-api-try-out false

Tanzu için Spring Cloud Gateway'de OpenAPI Belirtimi ile API yönlendirmeyi yapılandırma

Bu bölümde API portalda şema tanımlarıyla API'lerin nasıl görüntülenip denendiği açıklanmaktadır. Tanzu için Spring Cloud Gateway'de OpenAPI belirtim URL'si ile API yönlendirmeyi yapılandırmak için aşağıdaki adımları kullanın.

1. Azure Spring Apps'te ağ geçidinin trafiği yönlendiren bir uygulama oluşturun.

2. OpenAPI tanımını oluşturun ve buna erişmek için URI'yi alın. Aşağıdaki iki URI seçeneği kabul edilir:

   • İlk seçenek, OpenAPI belirtimini içeren URI https://petstore3.swagger.io/api/v3/openapi.jsongibi genel olarak erişilebilir bir uç nokta kullanmaktır.
   • İkinci seçenek, OpenAPI tanımını Azure Spring Apps'te uygulamanın göreli yoluna yerleştirmek ve URI'yi biçiminde http://<app-name>/<relative-path-to-OpenAPI-spec>oluşturmaktır. URI'nin gibi http://<app-name>/v3/api-docsolabilmesi için OpenAPI belirtimini otomatik olarak oluşturmak için gibi SpringDocs araçlar seçebilirsiniz.

3. Ağ geçidine erişmek üzere genel uç nokta atamak için aşağıdaki komutu kullanın.

   az spring gateway update --assign-endpoint
   

4. Tanzu özellikleri için Spring Cloud Gateway'i yapılandırmak için aşağıdaki komutu kullanın:

   az spring gateway update \
       --api-description "<api-description>" \
       --api-title "<api-title>" \
       --api-version "v0.1" \
       --server-url "<endpoint-in-the-previous-step>" \
       --allowed-origins "*"
   

5. Uygulamalara yönlendirme kurallarını yapılandırın.

   Tanzu için Spring Cloud Gateway yol yapılandırmasında uygulamaya erişmek üzere kurallar oluşturmak için aşağıdaki içeriği sample.json dosyasına kaydedin.

   {
      "open_api": {
         "uri": "https://petstore3.swagger.io/api/v3/openapi.json"
      },
      "routes": [
         {
            "title": "Petstore",
            "description": "Route to application",
            "predicates": [
               "Path=/pet",
               "Method=PUT"
            ],
            "filters": [
               "StripPrefix=0"
            ]
         }
      ]
   }
   

   open_api.uri Değer, yukarıdaki ikinci adımda yapılandırılan genel uç nokta veya URI'dir. OpenAPI belirtiminizde tanımlanan yollar için koşul ve filtreler ekleyebilirsiniz.

   Kuralı ilk adımda oluşturulan uygulamaya uygulamak için aşağıdaki komutu kullanın:

   az spring gateway route-config create \
       --name sample \
       --app-name <app-name> \
       --routes-file sample.json
   

6. Oluşturulan yolların yanıtını denetleyin. Yolları portalda da görüntüleyebilirsiniz.

Kullanıma sunulan API'leri API portalında görüntüleme

API portalına endpoint URL gitmek için öğesini seçin. Tanzu için Spring Cloud Gateway'de yapılandırılan tüm yolları görürsünüz.

API portalda API'leri deneyin

API'leri denemek için aşağıdaki adımları kullanın:

1. Denemek istediğiniz API'yi seçin.

2. YÜRÜT'e tıklayın ve yanıt görüntülenir.

   

Hizmet oluşturulduktan sonra API portalını etkinleştirme/devre dışı bırakma

Hizmet oluşturulduktan sonra Azure portalını veya Azure CLI'yı kullanarak API portalını etkinleştirebilir ve devre dışı bırakabilirsiniz. API portalını devre dışı bırakmadan önce uç noktasının atamasını kaldırmanız gerekir.

az spring api-portal create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

az spring api-portal delete \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

Sonraki adımlar

• Azure Spring Apps