summaryrefslogtreecommitdiffstats
path: root/platformdoc/docs/components/component-specification/start-here.md
diff options
context:
space:
mode:
authorLusheng Ji <lji@research.att.com>2017-09-11 23:38:09 +0000
committerLusheng Ji <lji@research.att.com>2017-09-12 01:42:11 +0000
commit1694802295e445771fe32bd3a14fefb53e3ab9fa (patch)
tree143e17efc193611ed1795e4c77ca2fdef028c818 /platformdoc/docs/components/component-specification/start-here.md
parent64472de4c2e2acc7bf883a3e8267ad5aa38e2cb0 (diff)
Make platformdoc docker container
Issue-Id: DCAEGEN2-60 Change-Id: Id57ab539707a43883ff957a23d2459a9b12df22e Signed-off-by: Lusheng Ji <lji@research.att.com>
Diffstat (limited to 'platformdoc/docs/components/component-specification/start-here.md')
-rw-r--r--platformdoc/docs/components/component-specification/start-here.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/platformdoc/docs/components/component-specification/start-here.md b/platformdoc/docs/components/component-specification/start-here.md
new file mode 100644
index 00000000..3816dd06
--- /dev/null
+++ b/platformdoc/docs/components/component-specification/start-here.md
@@ -0,0 +1,21 @@
+# Component specification
+
+Every component that onboards onto the DCAE platform requires a component specification. The component specification is a JSON artifact that fully describes your components. The format of the component specification is standardized for CDAP applications and Dockerized applications and is validated using [a JSON schema](ONAP URL TBD).
+
+The component specification is used by:
+
+* Design - TOSCA models are generated from the component specification so that your component can be used by designers to compose new DCAE services in SDC.
+* Policy - TOSCA models are generated from the component specification so that operations can create policy models used to dynamically configure your component.
+* Runtime platform - Your component's application configuration (JSON) is generated from the component specification and will be provided to your component at runtime.
+
+## dcae-cli
+
+Use the [`dcae-cli`](../dcae-cli/quickstart) tool to manage your component specification and to test your components with it.
+
+The dcae-cli can also be used to view component specifications that have already been added and published. Please check out the [shared catalog](../dcae-cli/walkthrough/#shared-catalog) for examples for both Docker and CDAP.
+
+## Next
+
+If you are building a CDAP application, review the [component specification details for CDAP](cdap-specification.md).
+
+If you are building a Dockerized application, review the [component specification details for Docker](docker-specification.md).