From a7ae1d202948d174d795a989c50f0de877ec8d9b Mon Sep 17 00:00:00 2001 From: Maxim Svistunov Date: Tue, 4 Apr 2023 08:30:16 +0200 Subject: [PATCH] Add a section on multi-container support for Serving Add new section to the topic maps Remove unnecessary step, improve description, minor fixes Better phrasing --- _topic_maps/_topic_map.yml | 2 ++ _topic_maps/_topic_map_osd.yml | 2 ++ _topic_maps/_topic_map_rosa.yml | 2 ++ ...s-configuring-multi-container-service.adoc | 34 +++++++++++++++++++ .../multi-container-support-for-serving.adoc | 13 +++++++ 5 files changed, 53 insertions(+) create mode 100644 modules/serverless-configuring-multi-container-service.adoc create mode 100644 serverless/knative-serving/config-applications/multi-container-support-for-serving.adoc diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 5c3d5dca3317..b5f713c4b125 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -3258,6 +3258,8 @@ Topics: Topics: - Name: Overriding system deployment configurations File: overriding-config-serving + - Name: Multi-container support + File: multi-container-support-for-serving - Name: EmptyDir volumes File: empty-dir - Name: Persistent Volume Claims diff --git a/_topic_maps/_topic_map_osd.yml b/_topic_maps/_topic_map_osd.yml index b5446bf6eb07..2ce1515e901d 100644 --- a/_topic_maps/_topic_map_osd.yml +++ b/_topic_maps/_topic_map_osd.yml @@ -271,6 +271,8 @@ Topics: Topics: - Name: Overriding system deployment configurations File: overriding-config-serving + - Name: Multi-container support + File: multi-container-support-for-serving - Name: EmptyDir volumes File: empty-dir - Name: Persistent Volume Claims diff --git a/_topic_maps/_topic_map_rosa.yml b/_topic_maps/_topic_map_rosa.yml index 31be2adc4aed..9d8d80ca4164 100644 --- a/_topic_maps/_topic_map_rosa.yml +++ b/_topic_maps/_topic_map_rosa.yml @@ -343,6 +343,8 @@ Topics: Topics: - Name: Overriding system deployment configurations File: overriding-config-serving + - Name: Multi-container support + File: multi-container-support-for-serving - Name: EmptyDir volumes File: empty-dir - Name: Persistent Volume Claims diff --git a/modules/serverless-configuring-multi-container-service.adoc b/modules/serverless-configuring-multi-container-service.adoc new file mode 100644 index 000000000000..ffda5cbd9440 --- /dev/null +++ b/modules/serverless-configuring-multi-container-service.adoc @@ -0,0 +1,34 @@ +// Module included in the following assemblies: +// +// * serverless/knative-serving/config-applications/multi-container-support-for-serving.adoc + +:_content-type: PROCEDURE +[id="serverless-configuring-multi-container-service_{context}"] += Configuring a multi-container service + +Multi-container support is enabled by default. You can create a multi-container pod by specifiying multiple containers in the service. + +.Procedure + +. Modify your service to include additional containers. Only one container can handle requests, so specify `ports` for exactly one container. Here is an example configuration with two containers: ++ +.Multiple containers configuration +[source,yaml] +---- +apiVersion: serving.knative.dev/v1 +kind: Service +... +spec: + template: + spec: + containers: + - name: first-container <1> + image: gcr.io/knative-samples/helloworld-go + ports: + - containerPort: 8080 <2> + - name: second-container <3> + image: gcr.io/knative-samples/helloworld-java +---- +<1> First container configuration. +<2> Port specification for the first container. +<3> Second container configuration. diff --git a/serverless/knative-serving/config-applications/multi-container-support-for-serving.adoc b/serverless/knative-serving/config-applications/multi-container-support-for-serving.adoc new file mode 100644 index 000000000000..8e092f106d07 --- /dev/null +++ b/serverless/knative-serving/config-applications/multi-container-support-for-serving.adoc @@ -0,0 +1,13 @@ +:_content-type: ASSEMBLY +include::_attributes/common-attributes.adoc[] +[id="multi-container-support-for-serving"] += Multi-container support for Serving +:context: multi-container-support-for-serving + +You can deploy a multi-container pod by using a single Knative service. This method is useful for separating application responsibilities into smaller, specialized parts. + +:FeatureName: Multi-container support for Serving +include::snippets/technology-preview.adoc[leveloffset=+2] + +// Multi-container support +include::modules/serverless-configuring-multi-container-service.adoc[leveloffset=+1]