Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Use a custom domain in Knative

Son Güncelleme:Oct 08, 2026

Knative Service için varsayılan etki alanı adı biçimi {route}.{namespace}.{default-example.com} şeklindedir; burada {default-example.com} varsayılan etki alanı son ekidir ve genellikle example.com olarak ayarlanır. ACK daha esnek rota yapılandırması için özel etki alanlarını destekler.

Etki alanlarını iki şekilde özelleştirebilirsiniz:

  • ConfigMap'i değiştirerek tüm Knative Service'ler için genel bir etki alanı özelleştirin.

  • Belirli bir Knative Service için özel bir etki alanını hızlıca yapılandırmak amacıyla knative.aliyun.com/serving-ingress açıklamasını (annotation) kullanabilirsiniz.

Ön koşullar

Genel özel etki alanı yapılandırma

Tüm Knative Service'ler için ortak bir etki alanı son eki uygulamak üzere aşağıdaki adımları izleyin.

  1. knative-serving ad alanında bulunan config-domain ConfigMap nesnesini düzenlemek için aşağıdaki komutu çalıştırın.

    kubectl edit cm config-domain --namespace knative-serving
  2. Yapılandırma dosyasını değiştirin.

    Yapılandırma dosyasındaki varsayılan etki alanı adı example.com değerini özel bir etki alanıyla değiştirin ve yapılandırmayı kaydedin. Bu örnekte özel etki alanı mydomain olarak ayarlanmıştır.

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: config-domain
      namespace: knative-serving
    data:
      mydomain.com: "" # Replace example.com with mydomain.com. In a real-world scenario, replace this with your own service domain.
  3. Yeni etki alanının uygulandığını doğrulamak için aşağıdaki komutu çalıştırın:

    # Replace helloworld-go with the name of your Knative Service.
    kubectl get route helloworld-go --output jsonpath="{.status.url}" | awk -F/ '{print $3}'

    Beklenen çıktı:

    helloworld-go.default.mydomain.com

    Bu çıktı, özel etki alanının uygulandığını gösterir.

  4. Etki alanınızın DNS kayıtlarını Knative ağ geçidinin IP adresine yönlendirecek şekilde güncelleyin.

  5. Knative Service'e özel etki alanı üzerinden erişmek için aşağıdaki komutu çalıştırın:

    curl http://helloworld-go.default.mydomain.com

    Beklenen çıktı:

    Hello Knative!

    Bu çıktı, Knative Service'e özel etki alanı üzerinden erişilebildiğini gösterir.

Hizmet başına etki alanı ve yol yapılandırma

Bir Knative Service için belirli bir etki alanı adı ve yol tanımlamak üzere knative.aliyun.com/serving-ingress açıklamasını kullanarak doğrudan özel bir etki alanı adı ve yol belirtebilirsiniz. Örneğin, knative.aliyun.com/serving-ingress: cafe.mydomain.com/coffee ifadesi cafe.mydomain.com etki alanı adını ve /coffee yolunu belirtir.

Özel etki alanı örneği

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: coffee-mydomain
  annotations:
    knative.aliyun.com/serving-ingress: cafe.mydomain.com
spec:
  template:
    spec:
      containers:
      - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:160e4dc8

Joker karakterli etki alanı örneği

Birden fazla etki alanını virgülle ayırın.
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: coffee-mydomain
  annotations:
    knative.aliyun.com/serving-ingress: "*.mydomain.com"
spec:
  template:
    spec:
      containers:
      - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:160e4dc8

Tek yol örneği

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: coffee-mydomain
  annotations:
    knative.aliyun.com/serving-ingress: cafe.mydomain.com/coffee
spec:
  template:
    spec:
      containers:
      - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:160e4dc8

Çoklu yol örneği

Birden fazla yolu virgülle ayırın.
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: coffee-mydomain
  annotations:
    knative.aliyun.com/serving-ingress: cafe.mydomain.com/coffee,cafe.mydomain.com/tea
spec:
  template:
    spec:
      containers:
      - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:160e4dc8

Yol yeniden yazma

ALB ağ geçidi yol yeniden yazmayı destekler. Bir Knative Service için Yolu yeniden yazmak amacıyla alb.ingress.kubernetes.io/rewrite-target: açıklamasını yapılandırabilirsiniz. Aşağıda bir kod örneği verilmiştir.

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: coffee-mydomain
  annotations:
    knative.aliyun.com/serving-ingress: cafe.mydomain.com/api/coffee
    alb.ingress.kubernetes.io/rewrite-target: /coffee
spec:
  template:
    spec:
      containers:
      - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:160e4dc8

Evrensel joker karakterli etki alanı yapılandırma

Bir Knative Service için joker karakterli etki alanı tanımlamak üzere knative.aliyun.com/serving-ingress açıklamasının değerini / olarak ayarlayın. Örneğin, knative.aliyun.com/serving-ingress: / ifadesi tam joker karakterli bir etki alanını belirtir. Aşağıda bir örnek verilmiştir.

Yalnızca ALB ağ geçitleri desteklenir.

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: coffee-mydomain
  annotations:
    knative.aliyun.com/serving-ingress: "/"
spec:
  template:
    spec:
      containers:
      - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:160e4dc8

İlgili konular