[
https://issues.apache.org/jira/browse/BEAM-8209?focusedWorklogId=317942&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-317942
]
ASF GitHub Bot logged work on BEAM-8209:
----------------------------------------
Author: ASF GitHub Bot
Created on: 25/Sep/19 00:43
Start Date: 25/Sep/19 00:43
Worklog Time Spent: 10m
Work Description: Hannah-Jiang commented on pull request #9607:
[BEAM-8209] Custom container docs
URL: https://github.com/apache/beam/pull/9607#discussion_r327878351
##########
File path: website/src/documentation/runtime/environments.md
##########
@@ -0,0 +1,187 @@
+---
+layout: section
+title: "Runtime environments"
+section_menu: section-menu/documentation.html
+permalink: /documentation/runtime/environments/
+redirect_from:
+ - /documentation/execution-model/
+---
+<!--
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+# Runtime environments
+
+Any execution engine can run the Beam SDK beacuse the SDK runtime environment
is [containerized](https://s.apache.org/beam-fn-api-container-contract) with
[Docker](https://www.docker.com/) and isolated from other runtime systems. This
page describes how to build, customize, and push Beam SDK container images.
+
+## Building container images
+
+Before building Beam SDK container images:
+* Register a [Bintray](https://bintray.com/) account with a Docker repository
named `apache`.
+* Install [Docker](https://www.docker.com/) on your workstation.
+
+To build Beam SDK container images:
+
+<ol>
+ <li>
+ Navigate to your local copy of the <a
href="https://github.com/apache/beam";><code>beam</code></a>
+ </li>
+ <li>
+ Run Gradle with the <code>docker</code> target: <pre>./gradlew
docker</pre>
+ </li>
+</ol>
+
+> **Note**: It may take a long time to build all of the container images. You
can instead build the images for specific SDKs:
+>
+> ```
+> ./gradlew -p sdks/java/container docker
+> ./gradlew -p sdks/python/container docker
+> ./gradlew -p sdks/go/container docker
+> ```
+
+Run `docker images` to examine the containers. For example, if you
successfully built the container images, the command prompt displays a response
like:
+
+```
+REPOSITORY TAG IMAGE
ID CREATED SIZE
+$USER-docker-apache.bintray.io/beam/python latest 4ea515403a1a
3 minutes ago 1.27GB
+$USER-docker-apache.bintray.io/beam/java latest 0103512f1d8f
34 minutes ago 780MB
+$USER-docker-apache.bintray.io/beam/go latest ce055985808a
35 minutes ago 121MB
+```
Review comment:
Let's use these examples.
```
REPOSITORY TAG IMAGE ID
CREATED SIZE
apachebeam/java_sdk latest 16ca619d489e
2 weeks ago 550MB
apachebeam/python2.7_sdk latest b6fb40539c29
2 weeks ago 1.78GB
apachebeam/python3.5_sdk latest bae309000d09
2 weeks ago 1.85GB
apachebeam/python3.6_sdk latest 42faad307d1a
2 weeks ago 1.86GB
apachebeam/python3.7_sdk latest 18267df54139
2 weeks ago 1.86GB
apachebeam/go_sdk latest 30cf602e9763
2 weeks ago 124MB
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
Issue Time Tracking
-------------------
Worklog Id: (was: 317942)
Time Spent: 3h 10m (was: 3h)
> Document custom docker containers
> ---------------------------------
>
> Key: BEAM-8209
> URL: https://issues.apache.org/jira/browse/BEAM-8209
> Project: Beam
> Issue Type: Sub-task
> Components: website
> Reporter: Cyrus Maden
> Assignee: Cyrus Maden
> Priority: Minor
> Fix For: 2.16.0
>
> Time Spent: 3h 10m
> Remaining Estimate: 0h
>
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
