From eaac78d809a0a019718cb8b070f496b6883bb130 Mon Sep 17 00:00:00 2001 From: Lusheng Ji Date: Wed, 6 Jun 2018 00:20:03 -0400 Subject: Fix doc build warnings Issue-ID: DCAEGEN2-516 Change-Id: I94f1c7fcf5e4a21752c3ce9d8d71d98f2140e1ee Signed-off-by: Lusheng Ji --- docs/sections/components/dcae-cli/commands.rst | 46 +++++++++++----------- docs/sections/components/dcae-cli/walkthrough.rst | 47 +++++++++-------------- 2 files changed, 42 insertions(+), 51 deletions(-) (limited to 'docs/sections/components/dcae-cli') diff --git a/docs/sections/components/dcae-cli/commands.rst b/docs/sections/components/dcae-cli/commands.rst index d34ba43d..4634472d 100644 --- a/docs/sections/components/dcae-cli/commands.rst +++ b/docs/sections/components/dcae-cli/commands.rst @@ -18,29 +18,29 @@ resource can have a status of ``staged`` or ``published``. By default, only ``published`` resources are displayed. To see ``staged`` resources, add the –expanded argument. -+-----------------------------------------------+-----------------------+ -| Catalog Status | Meaning | -+===============================================+=======================+ -| staged | resource has be added | -| | (and validated), but | -| | is under development | -+-----------------------------------------------+-----------------------+ -| staged data_formats can only be referenced in | -| their owners component specs | -+-----------------------------------------------+-----------------------+ -| staged components can only be deployed by | -| their owners | -+-----------------------------------------------+-----------------------+ -| published | resource has been | -| | tested and can be | -| | shared | -+-----------------------------------------------+-----------------------+ -| published data_formats can be used in | -| anyone’s component spec | -+-----------------------------------------------+-----------------------+ -| published components and be deployed by | -| anyone | -+-----------------------------------------------+-----------------------+ ++------------------------------+----------------------------------------+ +| Catalog Status | Meaning | ++==============================+========================================+ +| staged | resource has be added | +| | (and validated), but | +| | is under development | ++------------------------------+----------------------------------------+ +| staged | data_formats can only be referenced in | +| | their owners component specs | ++------------------------------+----------------------------------------+ +| staged | components can only be deployed by | +| | their owners | ++------------------------------+----------------------------------------+ +| published | resource has been | +| | tested and can be | +| | shared | ++------------------------------+----------------------------------------+ +| | published data_formats can be used in | +| | anyone's component spec | ++------------------------------+----------------------------------------+ +| | published components and be deployed by| +| | anyone | ++------------------------------+----------------------------------------+ :: diff --git a/docs/sections/components/dcae-cli/walkthrough.rst b/docs/sections/components/dcae-cli/walkthrough.rst index 559ba3ab..56c9e28e 100755 --- a/docs/sections/components/dcae-cli/walkthrough.rst +++ b/docs/sections/components/dcae-cli/walkthrough.rst @@ -267,21 +267,21 @@ registry. A docker component can be run in either ``attached`` or ``unattached`` mode. (Default is unattached). -+------------------+---------------------------------------------------+ -| Mode | Description | -+==================+===================================================+ -| attached | component is run in the ‘foreground’, container | -| | logs are streamed to stdout. Ctrl-C is used to | -| | terminate the dcae_cli session. | -+------------------+---------------------------------------------------+ -| unattached | component is run in the ‘background’, container | -| | logs are viewed via ``docker logs`` command, | -| | container runs until undeployed with dcae_cli | -| | ``undeploy`` command. | -+------------------+---------------------------------------------------+ ++------------------+-----------------------------------------------------------+ +| Mode | Description | ++==================+===========================================================+ +| attached | component is run in the foreground, container | +| | logs are streamed to stdout. Ctrl-C is used to | +| | terminate the dcae_cli session. | ++------------------+-----------------------------------------------------------+ +| unattached | component is run in the background container | +| | logs are viewed via ``docker logs`` command, | +| | container runs until undeployed with dcae_cli | +| | ``undeploy`` command. | ++------------------+-----------------------------------------------------------+ Run a component in attached mode: -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +--------------------------------- :: @@ -304,7 +304,7 @@ Run a component in attached mode: DCAE.Docker | INFO | Stopping container 'user12.dbb13a3c-d870-487e-b584-89929b856b5c.0-7-0.sandbox-platform-yourapp' and cleaning up... Run a component in unattached mode: -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +----------------------------------- :: @@ -317,14 +317,14 @@ Run a component in unattached mode: important to conserve resources in the environment. Run a component that subscribes to Dmaap Message Router or Data Router -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +---------------------------------------------------------------------- :: $ dcae_cli -v component run $component-that-uses-dmamp --dmaap-file $dmaap-connection-object Run a component that expects input that is ``sourced at deployment`` -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +-------------------------------------------------------------------- :: @@ -338,18 +338,9 @@ Run a component that expects input that is ``sourced at deployment`` Undeploy the component ---------------------- -+-----------------------------------------------------------------+ -| The ``undeploy`` command is used to undeploy any instance of a | -| specified component/version that you have deployed. This | -| includes cleaning up the configuration. | -+-----------------------------------------------------------------+ -| Undeploy ``sandbox.platform.yourapp:0.7.0`` that was deployed | -| above: | -+-----------------------------------------------------------------+ -| ``$ dcae_cli -v component undeploy sandbox.platform.yourapp:0.7.0 | -| DCAE.Undeploy | WARNING | Undeploying components: 1 DCAE.Undep | -| loy | WARNING | Undeployed components: 1`` | -+-----------------------------------------------------------------+ +The ``undeploy`` command is used to undeploy any instance of a specified component/version that you have deployed. This includes cleaning up the configuration. +Undeploy ``sandbox.platform.yourapp:0.7.0`` that was deployed above: +``$ dcae_cli -v component undeploy sandbox.platform.yourapp:0.7.0 DCAE.Undeploy | WARNING | Undeploying components: 1 DCAE.Undeploy | WARNING | Undeployed components: 1`` .. _dcae_cli_publish_the_component_and_data_format: -- cgit 1.2.3-korg