[skywalking] branch master updated: Add Docker image doc (#6780)

[wu...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

wusheng pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/skywalking.git


The following commit(s) were added to refs/heads/master by this push:
     new 10c4747  Add Docker image doc (#6780)
10c4747 is described below

commit 10c47471558c4a5eaf9bf608f9c3efd5a80d3660
Author: Zhenxu Ke <ke...@apache.org>
AuthorDate: Mon Apr 19 08:09:50 2021 +0800

    Add Docker image doc (#6780)
---
 .../service-agent/java-agent/containerization.md   | 50 ++++++++++++++++++++++
 docs/menu.yml                                      |  4 ++
 2 files changed, 54 insertions(+)

diff --git a/docs/en/setup/service-agent/java-agent/containerization.md b/docs/en/setup/service-agent/java-agent/containerization.md
new file mode 100644
index 0000000..28b1394
--- /dev/null
+++ b/docs/en/setup/service-agent/java-agent/containerization.md
@@ -0,0 +1,50 @@
+# Docker
+
+This section introduces how to build your Java application image on top of this image.
+
+```dockerfile
+FROM apache/skywalking-java-agent:8.5.0-jdk8
+
+# ... build your java application
+```
+
+You can start your Java application with `CMD` or `ENTRYPOINT`, but you don't need to care about the Java options to
+enable SkyWalking agent, it should be adopted automatically.
+
+# Kubernetes
+
+This section introduces how to use this image as sidecar of Kubernetes service.
+
+In Kubernetes scenarios, you can also use this agent image as a sidecar.
+
+```yaml
+apiVersion: v1
+kind: Pod
+metadata:
+  name: agent-as-sidecar
+spec:
+  restartPolicy: Never
+
+  volumes:
+    - name: skywalking-agent
+      emptyDir: { }
+
+  containers:
+    - name: agent-container
+      image: apache/skywalking-java-agent:8.4.0-alpine
+      volumeMounts:
+        - name: skywalking-agent
+          mountPath: /agent
+      command: [ "/bin/sh" ]
+      args: [ "-c", "cp -R /skywalking/agent /agent/" ]
+
+    - name: app-container
+      image: springio/gs-spring-boot-docker
+      volumeMounts:
+        - name: skywalking-agent
+          mountPath: /skywalking
+      env:
+        - name: JAVA_TOOL_OPTIONS
+          value: "-javaagent:/skywalking/agent/skywalking-agent.jar"
+```
+
diff --git a/docs/menu.yml b/docs/menu.yml
index 56616fe..8599776 100644
--- a/docs/menu.yml
+++ b/docs/menu.yml
@@ -61,6 +61,10 @@ catalog:
         catalog:
         - name: "Setup"
           path: "/en/setup/service-agent/java-agent/readme"
+        - name: "Setup in Docker"
+          path: "/en/setup/service-agent/java-agent/containerization#docker"
+        - name: "Setup in Kubernetes"
+          path: "/en/setup/service-agent/java-agent/containerization#kubernetes"
         - name: "Supported middleware, framework and library"
           path: "/en/setup/service-agent/java-agent/Supported-list"
         - name: "Agent Configuration Properties"