From 56d11ddb1eaa3e52ef9de703ece57e1b9e43cf13 Mon Sep 17 00:00:00 2001 From: Kalyani Desai Date: Wed, 22 May 2024 13:31:00 +0530 Subject: [PATCH] Created http configuration folder --- _topic_maps/_topic_map.yml | 13 +++++--- .../http-configuration/_attributes | 1 + .../http1-full-duplex-support.adoc | 31 +++++++++++++++++++ .../https-redirect-global.adoc | 0 .../https-redirect-per-service.adoc | 0 knative-serving/http-configuration/images | 1 + knative-serving/http-configuration/modules | 1 + knative-serving/http-configuration/snippets | 1 + modules/serverless-https-redirect-global.adoc | 2 +- 9 files changed, 45 insertions(+), 5 deletions(-) create mode 120000 knative-serving/http-configuration/_attributes create mode 100644 knative-serving/http-configuration/http1-full-duplex-support.adoc rename knative-serving/{external-ingress-routing => http-configuration}/https-redirect-global.adoc (100%) rename knative-serving/{external-ingress-routing => http-configuration}/https-redirect-per-service.adoc (100%) create mode 120000 knative-serving/http-configuration/images create mode 120000 knative-serving/http-configuration/modules create mode 120000 knative-serving/http-configuration/snippets diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index cb66049ebb67..bc4d7165f943 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -160,12 +160,8 @@ Topics: File: customize-labels-annotations-routes - Name: Configuring routes for Knative services File: configuring-service-routes - - Name: Global HTTPS redirection - File: https-redirect-global - Name: URL scheme for external routes File: url-scheme-external-routes - - Name: HTTPS redirection per service - File: https-redirect-per-service - Name: Cluster local availability File: cluster-local-availability - Name: Kourier Gateway service type @@ -174,6 +170,15 @@ Topics: File: using-http2-gRPC - Name: Using Serving with OpenShift ingress sharding File: using-serving-with-ingress-sharding +- Name: HTTP configuration + Dir: http-configuration + Topics: + - Name: Global HTTPS redirection + File: https-redirect-global + - Name: HTTPS redirection per service + File: https-redirect-per-service + - Name: Full duplex support for HTTP/1 + File: http1-full-duplex-support - Name: Configuring access to Knative services Dir: config-access Topics: diff --git a/knative-serving/http-configuration/_attributes b/knative-serving/http-configuration/_attributes new file mode 120000 index 000000000000..20cc1dcb77bf --- /dev/null +++ b/knative-serving/http-configuration/_attributes @@ -0,0 +1 @@ +../../_attributes/ \ No newline at end of file diff --git a/knative-serving/http-configuration/http1-full-duplex-support.adoc b/knative-serving/http-configuration/http1-full-duplex-support.adoc new file mode 100644 index 000000000000..680e5f428974 --- /dev/null +++ b/knative-serving/http-configuration/http1-full-duplex-support.adoc @@ -0,0 +1,31 @@ +:_content-type: ASSEMBLY +include::_attributes/common-attributes.adoc[] +[id="http1-full-duplex-support"] += Full duplex support for HTTP/1 +:context: http1-full-duplex-support + +You can enable the HTTP/1 full duplex support for a service by configuring the `features.knative.dev/http-full-duplex` annotation. + +[NOTE] +==== +Verify your HTTP clients before enabling, as earlier version clients might not provide support for HTTP/1 full duplex. +==== + +The following example shows how you can use this annotation in a Knative `Service` YAML object at the revision spec level: + +.Example `KnativeServing` CR that provides full duplex support for HTTP/1 +[source,yaml] +---- +apiVersion: serving.knative.dev/v1 +kind: Service +metadata: + name: example-service + namespace: default +spec: + template: + spec: + annotations: + features.knative.dev/http-full-duplex: "Enabled" +... +---- + diff --git a/knative-serving/external-ingress-routing/https-redirect-global.adoc b/knative-serving/http-configuration/https-redirect-global.adoc similarity index 100% rename from knative-serving/external-ingress-routing/https-redirect-global.adoc rename to knative-serving/http-configuration/https-redirect-global.adoc diff --git a/knative-serving/external-ingress-routing/https-redirect-per-service.adoc b/knative-serving/http-configuration/https-redirect-per-service.adoc similarity index 100% rename from knative-serving/external-ingress-routing/https-redirect-per-service.adoc rename to knative-serving/http-configuration/https-redirect-per-service.adoc diff --git a/knative-serving/http-configuration/images b/knative-serving/http-configuration/images new file mode 120000 index 000000000000..847b03ed0541 --- /dev/null +++ b/knative-serving/http-configuration/images @@ -0,0 +1 @@ +../../images/ \ No newline at end of file diff --git a/knative-serving/http-configuration/modules b/knative-serving/http-configuration/modules new file mode 120000 index 000000000000..36719b9de743 --- /dev/null +++ b/knative-serving/http-configuration/modules @@ -0,0 +1 @@ +../../modules/ \ No newline at end of file diff --git a/knative-serving/http-configuration/snippets b/knative-serving/http-configuration/snippets new file mode 120000 index 000000000000..5a3f5add140e --- /dev/null +++ b/knative-serving/http-configuration/snippets @@ -0,0 +1 @@ +../../snippets/ \ No newline at end of file diff --git a/modules/serverless-https-redirect-global.adoc b/modules/serverless-https-redirect-global.adoc index 913dfe8e7099..854301c33a62 100644 --- a/modules/serverless-https-redirect-global.adoc +++ b/modules/serverless-https-redirect-global.adoc @@ -1,6 +1,6 @@ // Module included in the following assemblies: // -// * serverless/knative-serving/external-ingress-routing/https-redirect-global.adoc +// * serverless/knative-serving/http-configuration/https-redirect-global.adoc :_content-type: REFERENCE [id="serverless-https-redirect-global_{context}"]