You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beam.apache.org by ib...@apache.org on 2020/05/15 23:48:15 UTC
[beam] branch master updated: [BEAM-9136] Update doc about docker
image license pulling
This is an automated email from the ASF dual-hosted git repository.
ibzib pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/beam.git
The following commit(s) were added to refs/heads/master by this push:
new 7cf676b [BEAM-9136] Update doc about docker image license pulling
new bdd46e8 Merge pull request #11717 from Hannah-Jiang/new-doc
7cf676b is described below
commit 7cf676b52149114f65d258cbb3deee7f0d89cd59
Author: Hannah-Jiang <ji...@gmail.com>
AuthorDate: Thu May 14 21:47:23 2020 -0700
[BEAM-9136] Update doc about docker image license pulling
---
CHANGES.md | 4 ++++
website/www/site/content/en/documentation/runtime/environments.md | 8 ++++++--
2 files changed, 10 insertions(+), 2 deletions(-)
diff --git a/CHANGES.md b/CHANGES.md
index 29db42c..f1915fb 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -127,6 +127,9 @@ conversion to beam schema options. *Remark: Schema aware is still experimental.*
([BEAM-9147](https://issues.apache.org/jira/browse/BEAM-9147))
* Added integration of Java SDK with Google Cloud AI natural language processing API
([BEAM-9634](https://issues.apache.org/jira/browse/BEAM-9634))
+* `docker-pull-licenses` tag was introduced. Licenses/notices of third party dependencies will be added to the docker images when `docker-pull-licenses` was set.
+ The files are added to `/opt/apache/beam/third_party_licenses/`.
+ By default, no licenses/notices are added to the docker images. ([BEAM-9136](https://issues.apache.org/jira/browse/BEAM-9136))
## Breaking Changes
@@ -135,6 +138,7 @@ conversion to beam schema options. *Remark: Schema aware is still experimental.*
* HBaseIO.ReadAll now requires a PCollection of HBaseIO.Read objects instead of HBaseQuery objects ([BEAM-9279](https://issues.apache.org/jira/browse/BEAM-9279)).
* ProcessContext.updateWatermark has been removed in favor of using a WatermarkEstimator ([BEAM-9430](https://issues.apache.org/jira/browse/BEAM-9430)).
* Coder inference for PCollection of Row objects has been disabled ([BEAM-9569](https://issues.apache.org/jira/browse/BEAM-9569)).
+* Go SDK docker images are no longer released until further notice.
## Deprecations
* Java SDK: Beam Schema FieldType.getMetadata is now deprecated and is replaced by the Beam
diff --git a/website/www/site/content/en/documentation/runtime/environments.md b/website/www/site/content/en/documentation/runtime/environments.md
index b37e300..61d904e 100644
--- a/website/www/site/content/en/documentation/runtime/environments.md
+++ b/website/www/site/content/en/documentation/runtime/environments.md
@@ -94,8 +94,8 @@ python -m apache_beam.examples.wordcount \
To build Beam SDK container images:
-1. Navigate to the local copy of your [customized container image](#customizing-container-images).
-2. Run Gradle with the `docker` target. If you're [building a child image](#writing-new-dockerfiles), set the optional `--file` flag to the new Dockerfile. If you're [building an image from an original Dockerfile](#modifying-dockerfiles), ignore the `--file` flag and use a default repository:
+1. Navigate to the root directory of the local copy of your Apache Beam.
+2. Run Gradle with the `docker` target. If you're [building a child image](#writing-new-dockerfiles), set the optional `--file` flag to the new Dockerfile. If you're [building an image from an original Dockerfile](#modifying-dockerfiles), ignore the `--file` flag:
```
# The default repository of each SDK
@@ -110,6 +110,10 @@ To build Beam SDK container images:
./gradlew [--file=path/to/new/Dockerfile] :sdks:python:container buildAll
```
+From 2.21.0, `docker-pull-licenses` tag was introduced. Licenses/notices of third party dependencies will be added to the docker images when `docker-pull-licenses` was set.
+For example, `./gradlew :sdks:java:container:docker -Pdocker-pull-licenses`. The files are added to `/opt/apache/beam/third_party_licenses/`.
+By default, no licenses/notices are added to the docker images.
+
To examine the containers that you built, run `docker images` from anywhere in the command line. If you successfully built all of the container images, the command prints a table like the following:
```
REPOSITORY TAG IMAGE ID CREATED SIZE