From 978b05861ae1d7cd09c5a004324aea72bcfcbc4b 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 c0c25b2c12fc..e43963f7c2e3 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -3819,6 +3819,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 049530ee09d3..bfd378cf35f8 100644 --- a/_topic_maps/_topic_map_osd.yml +++ b/_topic_maps/_topic_map_osd.yml @@ -427,6 +427,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 054adfe308e9..f539524d3f24 100644 --- a/_topic_maps/_topic_map_rosa.yml +++ b/_topic_maps/_topic_map_rosa.yml @@ -615,6 +615,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]