Azure Spring Apps'te giriş yapılandırmasını özelleştirme
Not
Temel, Standart ve Kurumsal planları, 3 yıllık kullanımdan kaldırma süresiyle Mart 2025 ortasından itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.
Standart tüketim ve ayrılmış plan, altı ay sonra tamamen kapatılarak 30 Eylül 2024'den itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps Standart tüketimini ve ayrılmış planı Azure Container Apps'e geçirme.
Bu makale şunlar için geçerlidir: ✔️ Temel/Standart ✔️ Kurumsal
Bu makalede, Azure portalını ve Azure CLI'yı kullanarak Azure Spring Apps'te bir uygulamanın giriş ayarlarını ayarlama ve güncelleştirme adımları gösterilmektedir.
Azure Spring Apps hizmeti, uygulama trafiği yönetimini işlemek için temel alınan bir giriş denetleyicisi kullanır. Özelleştirme için aşağıdaki giriş ayarları desteklenir.
| Veri Akışı Adı | Giriş ayarı | Default value | Geçerli aralık | Açıklama |
|---|---|---|---|---|
ingress-read-timeout |
proxy-read-timeout |
300 | [1,1800] | Proksid bir sunucudan yanıt okumak için saniyeler içinde zaman aşımı. |
ingress-send-timeout |
proxy-send-timeout |
60 | [1,1800] | İsteğin prxied sunucusuna iletilmesi için saniyeler içinde zaman aşımı. |
session-affinity |
affinity |
Hiçbiri | Session, None |
İsteği yapan benşim türü, önceki isteği yanıtlayan pod çoğaltmasına gelir. Oturum benzitesini etkinleştirmek için Tanımlama Bilgisi olarak ayarlayın session-affinity . Yalnızca portalda oturum benzitesini etkinleştir kutusunu seçmeniz gerekir. |
session-max-age |
session-cookie-max-age |
0 | [0, 604800] | Tanımlama bilgisi yönergesine karşılık gelen, tanımlama bilgisinin süresi dolana kadar saniye olarak süre Max-Age . 0 olarak ayarlarsanız session-max-age süre sonu, tarayıcı oturum süresine eşittir. |
backend-protocol |
backend-protocol |
Varsayılan | Temerrüt GRPC |
NGINX'in arka uç hizmetiyle nasıl iletişim kuracaklarını belirtmek için arka uç protokollerini ayarlar. Varsayılan, HTTP/HTTPS/WebSocket anlamına gelir. Bu backend-protocol ayar yalnızca istemciden uygulamaya trafik için geçerlidir. Aynı hizmet örneği içindeki uygulamadan uygulamaya trafik için, ayarı değiştirmeden backend-protocol uygulamadan uygulamaya trafik için herhangi bir protokol seçin. Protokol, aynı hizmet örneği içindeki uygulamadan uygulamaya trafik için seçtiğiniz protokolü kısıtlamaz. |
client-auth |
client-auth |
0 öğe seçili | - | TLS/SSL ayarlarında karşıya yüklediğiniz ortak anahtarı içeren sertifikaları seçin. Giriş, bu sertifikaları birleştirir ve istemci kimlik doğrulaması için kullanır. |
Önkoşullar
Azure aboneliği. Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Azure Spring Apps uzantısıyla Azure CLI . Önceki sürümleri kaldırmak ve en son uzantıyı yüklemek için aşağıdaki komutu kullanın. Spring-cloud uzantısını daha önce yüklediyseniz yapılandırma ve sürüm uyuşmazlıklarını önlemek için bu uzantıyı kaldırın.
az extension remove --name spring az extension add --name spring az extension remove --name spring-cloud
Giriş yapılandırmasını ayarlama
Oluştururken giriş yapılandırmasını ayarlamak için aşağıdaki Azure CLI komutunu kullanın.
az spring app create \
--resource-group <resource-group-name> \
--service <service-name> \
--name <app-name> \
--ingress-read-timeout 300 \
--ingress-send-timeout 60 \
--session-affinity Cookie \
--session-max-age 1800 \
--backend-protocol Default \
--client-auth-certs <cert-id>
Not
cert-id Değer biçimindedir/subscriptions/<your-sub-id>/resourceGroups/<resource-group-name>/providers/Microsoft.AppPlatform/Spring/<service-name>/certificates/<cert-name>. Değeri almak cert-id için aşağıdaki komutu kullanın: az spring certificate show --service <service-instance-name> --resource-group <resource-group-name> --name <certificate-name> --query id
Bu komut aşağıdaki ayarlara sahip bir uygulama oluşturur:
- Giriş okuma zaman aşımı: 300 saniye
- Giriş gönderme zaman aşımı: 60 saniye
- Oturum benzimliği: Tanımlama Bilgisi
- Oturum çerezi en fazla yaş: 1800 saniye
- Arka uç protokolü: Varsayılan
- İstemci Kimlik Doğrulaması: cert-name
Mevcut bir uygulama için giriş ayarlarını güncelleştirme
Mevcut bir hizmet örneği tarafından barındırılan bir uygulamanın giriş ayarlarını güncelleştirmek için aşağıdaki adımları kullanın.
Azure Spring Apps örneğini içeren Azure aboneliğiyle ilişkilendirilmiş bir hesabı kullanarak portalda oturum açın.
Uygulamalar bölmesine gidin ve yapılandırmak istediğiniz uygulamayı seçin.
Yapılandırma bölmesine gidin ve giriş ayarları sekmesini seçin.
Giriş ayarlarını güncelleştirin ve kaydet'i seçin.
SSS
gRPC'yi nasıl etkinleştirebilirsiniz?
Arka uç protokolunu GRPC olarak ayarlayın.
WebSocket'i nasıl etkinleştirebilirsiniz?
Arka uç protokolunu Varsayılan olarak ayarlarsanız WebSocket varsayılan olarak etkinleştirilir. WebSocket bağlantı sınırı 20000'dir. Bu sınıra ulaştığınızda bağlantı başarısız olur.
RSocket'i WebSocket tabanlı olarak da kullanabilirsiniz.
Giriş yapılandırması ile giriş ayarları arasındaki fark nedir?
Giriş yapılandırması Azure CLI ve SDK'da kullanılabilir ve bu ayar hizmet örneği içindeki tüm uygulamalar için geçerlidir. Giriş ayarları bir uygulamayı yapılandırdıktan sonra, Giriş yapılandırması uygulamayı etkileyemez. Gelecekte desteklemeyi durdurmayı planladığımız için yeni betiklerin giriş yapılandırması kullanmasını önermiyoruz.
Giriş ayarları App Gateway/APIM ile birlikte kullanıldığında hem Azure Spring Apps girişinde hem de App Gateway/APIM'de zaman aşımını ayarladığınızda ne olur?
Daha kısa zaman aşımı kullanılır.
gRPC veya WebSocket için uçtan uca desteğe sahip olmanız gerekiyorsa App Gateway/APIM'de ek yapılandırmaya mı ihtiyacınız var?
App Gateway gRPC'yi desteklediği sürece ek yapılandırmaya ihtiyacınız yoktur.
Yapılandırılabilir bağlantı noktası destekleniyor mu?
Yapılandırılabilir bağlantı noktası şu anda desteklenmiyor (80/443).