Skip to content

G
Gpdb

Greenplum / Gpdb

通知 7
Star 1
Fork 0
G
Gpdb

体验新版 GitCode，发现更多精彩内容 >>

提交 389ba7b1 编写于 作者: L Lisa Owen 提交者： David Yozie
浏览文件
操作

docs - document the new plcontainer --use_local_copy option (#10021) 

* docs - document the new plcontainer --use_local_copy option

* add more words around when to use the option
Co-authored-by: NDavid Yozie <dyozie@pivotal.io>
上级 209d5f51
隐藏空白更改
内联 并排
Showing with 34 addition and 19 deletion
gpdb-doc/dita/analytics/pl_container.xml
浏览文件 @ 389ba7b1
......@@ -190,7 +190,7 @@ gpconfig -c shared_preload_libraries -v 'diskquota,plc_coordinator'</codeblock><
<section id="install_docker_images">
<title>Install PL/Container Docker Images</title>
<p>Install the Docker images that PL/Container will use to create language specific
<p>Install the Docker images that PL/Container will use to create language-specific
containers to run the UDFs.</p>
<!--oss only content-->
<p otherprops="oss-only">The PL/Container open source module contains dockerfiles to build
......@@ -212,9 +212,9 @@ gpconfig -c shared_preload_libraries -v 'diskquota,plc_coordinator'</codeblock><
with the associated <filepath>plcontainer-r-image-3.0.0-beta-gp6.tar.gz</filepath>
image.</li>
<li>
<p>Use the <codeph>plcontainer </codeph> utility command <codeph>image-add</codeph> to
install the images on all Greenplum Database hosts where <codeph>-f
</codeph>indicates the location of the downloaded files: </p>
<p>Use the <codeph>plcontainer image-add</codeph> command to install an image on
all Greenplum Database hosts. Provide the <codeph>-f</codeph> option to specify
the file system location of a downloaded image file. For example: </p>
<codeblock># Install a Python 2 based Docker image
plcontainer image-add -f /home/gpadmin/plcontainer-python-image-2.1.1-gp6.tar.gz
......@@ -231,6 +231,11 @@ plcontainer image-add -f /home/gpadmin/plcontainer-r-image-3.0.0-beta-gp6.tar.gz
20200127:21:54:43:004607 plcontainer:mdw:gpadmin-[INFO]:-Distributing image file /home/gpadmin/plcontainer-python-images-1.5.0.tar to all hosts...
20200127:21:54:55:004607 plcontainer:mdw:gpadmin-[INFO]:-Loading image on all hosts...
20200127:21:55:37:004607 plcontainer:mdw:gpadmin-[INFO]:-Removing temporary image files on all hosts...</codeblock>
<p>By default, the <codeph>image-add</codeph> command copies the image to each Greenplum
Database segment and standby master host, and installs the image. When you specify
the <codeph>[-ulc | --use_local_copy]</codeph> option, <codeph>plcontainer</codeph>
installs the image only on the host on which you execute the command. Use this option
when the PL/Container image already resides on disk on a host.</p>
<p>For more information on <codeph>image-add</codeph> options, visit the <xref
href="../utility_guide/ref/plcontainer.xml#topic_rw3_52s_dw">plcontainer </xref> reference page. </p>
</li>
......
gpdb-doc/dita/utility_guide/ref/plcontainer-configuration.xml
浏览文件 @ 389ba7b1
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic id="topic_sk1_gdq_dw">
<topic id="topic1">
<title>plcontainer Configuration File</title>
<body>
<p>The Greenplum Database utility <codeph>plcontainer</codeph> manages the
......
gpdb-doc/dita/utility_guide/ref/plcontainer.xml
浏览文件 @ 389ba7b1
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic id="topic_rw3_52s_dw">
<topic id="topic1">
<title>plcontainer </title>
<body>
<p>The <codeph>plcontainer</codeph> utility installs Docker images and manages the
......@@ -22,7 +22,7 @@
<title>plcontainer Syntax</title>
<codeblock><b>plcontainer</b> [<varname>command</varname>] [<b>-h</b> | <b>--help</b>] [<b>--verbose</b>]</codeblock>
<p>Where <varname>command</varname> is one of the following.</p>
<codeblock> image-add {{<b>-f</b> | <b>--file</b>} <varname>image_file</varname>} | {{<b>-u</b> | <b>--URL</b>} <varname>image_URL</varname>}
<codeblock> image-add {{<b>-f</b> | <b>--file</b>} <varname>image_file</varname> [<b>-ulc</b> | <b>--use_local_copy</b>]} | {{<b>-u</b> | <b>--URL</b>} <varname>image_URL</varname>}
image-delete {<b>-i</b> | <b>--image</b>} <varname>image_name</varname>
image-list
......@@ -49,15 +49,20 @@
<pt>image-add <varname>location</varname></pt>
<pd>Install a Docker image on the Greenplum Database hosts. Specify either the location
of the Docker image file on the host or the URL to the Docker image. These are the
supported location options.<ul id="ul_ihd_dsv_gcb">
<li>{<b>-f</b> | <b>--file</b>} <varname>image_file</varname> Specify the tar
archive file on the host that contains the Docker image. This example points to an
image file in the gpadmin home directory
supported location options:<ul id="ul_ihd_dsv_gcb">
<li>{<b>-f</b> | <b>--file</b>} <varname>image_file</varname> Specify the file
system location of the Docker image tar archive file on the local host. This example
specifies an image file in the <codeph>gpadmin</codeph> user's home directory:
<codeph>/home/gpadmin/test_image.tar.gz</codeph></li>
<li>{<b>-u</b> | <b>--URL</b>} <varname>image_URL</varname> Specify the URL of the
Docker repository and image. This example URL points to a local Docker repository
<codeph>192.168.0.1:5000/images/mytest_plc_r:devel</codeph></li>
</ul></pd>
<pd>By default, the <codeph>image-add</codeph> command copies the image to each
Greenplum Database segment and standby master host, and installs the image.
When you specify an <varname>image_file</varname> and provide the
[<b>-ulc</b> | <b>--use_local_copy</b>] option, <codeph>plcontainer</codeph>
installs the image only on the host on which you execute the command.</pd>
<pd>After installing the Docker image, use the <codeph><xref
href="#topic_rw3_52s_dw/runtime_add" format="dita">runtime-add</xref></codeph>
command to configure PL/Container to use the Docker image.</pd>
......@@ -83,7 +88,7 @@
<pd>
<parml>
<plentry>
<pt>{-i | --image} <varname>docker-image</varname></pt>
<pt>{<b>-i</b> | <b>--image</b>} <varname>docker-image</varname></pt>
<pd>Required. Specify the full Docker image name, including the tag, that is
installed on the Greenplum Database hosts. For example
<codeph>pivotaldata/plcontainer_python:1.0.0</codeph>. </pd>
......@@ -93,7 +98,7 @@
information including the name and tag (the Repository and Tag columns).</pd>
</plentry>
<plentry>
<pt>{-l | --language} python | python3 | r</pt>
<pt>{<b>-l</b> | <b>--language</b>} python | python3 | r</pt>
<pd>Required. Specify the PL/Container language type, supported values are
<codeph>python</codeph> (PL/Python using Python 2), <codeph>python3</codeph>
(PL/Python using Python 3) and <codeph>r</codeph> (PL/R). When adding
......@@ -154,7 +159,7 @@
</ul></pd>
</plentry>
<plentry>
<pt>{-v | --volume} <varname>shared-volume</varname></pt>
<pt>{<b>-v</b> | <b>--volume</b>} <varname>shared-volume</varname></pt>
<pd>Optional. Specify a Docker volume to bind mount. You can specify this option
multiple times to define multiple volumes.</pd>
<pd>The format for a shared volume:
......@@ -254,13 +259,13 @@
</pd>
</plentry>
<plentry>
<pt>-h | --help</pt>
<pt><b>-h</b> | <b>--help</b></pt>
<pd>Display help text. If specified without a command, displays help for all
<codeph>plcontainer</codeph> commands. If specified with a command, displays help
for the command.</pd>
</plentry>
<plentry>
<pt>--verbose</pt>
<pt><b>--verbose</b></pt>
<pd>Enable verbose logging for the command.</pd>
</plentry>
</parml>
......@@ -275,6 +280,9 @@
installing the Docker image, you add or update a runtime entry in the PL/Container
configuration file to give PL/Container access to the Docker image to start Docker
containers.</p></li>
<li>Install the Docker image only on the local Greenplum Database host:
<codeblock>plcontainer image-add -f /home/gpadmin/plc_python_image.tar.gz --use_local_copy</codeblock>
</li>
<li>Add a container entry to the PL/Container configuration file. This example adds
configuration information for a PL/R runtime, and specifies a shared volume and
settings for memory and logging.
......@@ -313,4 +321,4 @@
</ul>
</section>
</body>
</topic>
\ No newline at end of file
</topic>
gpdb-doc/dita/utility_guide/utility-programs.xml
浏览文件 @ 389ba7b1
......@@ -79,10 +79,10 @@
<p><xref href="ref/gpscp.xml#topic1" type="topic" format="dita"/></p>
<p otherprops="pivotal"><xref href="https://greenplum.docs.pivotal.io/streaming-server/1-3-1/ref/gpss-ref.html"
format="html" scope="external">gpss</xref><sup>4</sup></p>
</stentry>
<stentry>
<p><xref href="ref/gpssh.xml#topic1" type="topic" format="dita"/></p>
<p><xref href="ref/gpssh-exkeys.xml#topic1" type="topic" format="dita"/></p>
</stentry>
<stentry>
<p><xref href="ref/gpstart.xml#topic1" type="topic" format="dita"/></p>
<p><xref href="ref/gpstate.xml#topic1" type="topic" format="dita"/></p>
<p><xref href="ref/gpstop.xml#topic1" type="topic" format="dita"/></p>
......@@ -93,6 +93,8 @@
<p><xref href="ref/pg_restore.xml#topic1"/></p>
<p><xref href="ref/pgbouncer.xml#topic1"/></p>
<p><xref href="ref/pgbouncer-ini.xml#topic1"/></p>
<p><xref href="ref/plcontainer.xml#topic1" type="topic" format="dita"/></p>
<p><xref href="ref/plcontainer-configuration.xml#topic1" type="topic" format="dita"/></p>
<p><xref href="ref/psql.xml#topic1"/><sup otherprops="pivotal">3</sup></p>
<p><xref href="../pxf/ref/pxf.html" format="html" scope="peer">pxf</xref></p>
<p><xref href="../pxf/ref/pxf-cluster.html" format="html" scope="peer">pxf
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或