diff options
author | 2019-11-12 16:04:20 -0500 | |
---|---|---|
committer | 2019-12-13 16:46:11 -0500 | |
commit | c698e66797bad69b4c77b26b487bf8322989beb0 (patch) | |
tree | e40a8449728768107e4ab4c1ac506af13230a580 /mod/component-json-schemas/README.md | |
parent | 9cb529e42f5625f2fa802e21919b10f814a89ca7 (diff) |
Copy dcae-cli->onboardingapi, copy component specs
Issue-ID: DCAEGEN2-1860
Change-Id: I4805398c76479fad51cbdb74470ccc8f706ce9dc
Signed-off-by: Michael Hwang <mhwang@research.att.com>
Diffstat (limited to 'mod/component-json-schemas/README.md')
-rw-r--r-- | mod/component-json-schemas/README.md | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/mod/component-json-schemas/README.md b/mod/component-json-schemas/README.md new file mode 100644 index 0000000..f1dfcd5 --- /dev/null +++ b/mod/component-json-schemas/README.md @@ -0,0 +1,36 @@ +# Component JSON Schemas + +This repository contains the custom JSON schemas to support the onboarding of components: + +* Component specification schema +* Auxilary component specification schema for Docker +* Auxilary component specification schema for CDAP +* Data formats schema + +## Testing changes + +Use the Python `jsonschema` command-line tool to do validation checks: + +Example: + +``` +$ jsonschema -i tests/component-spec-docker.json component-spec-schema.json +``` + +## Uploading to Nexus + +For the component specification schema: + +``` +curl -v --user <user>:<password> https://<your file server host>/schemas/component-specification/<tag>/component-spec-schema.json --upload-file component-spec-schema.json +``` + +For the data format schema: + +``` +curl -v --user <user>:<password> https://<your file server host>/schemas/data-format/<tag>/data-format-schema.json --upload-file data-format-schema.json +``` + +### `dcae-cli` + +The `dcae-cli` looks for these schemas under a tag that is of the format `dcae-cli-v<major version>` where the major version is an integer that is the major part of semver. For schema changes that are breaking, you must bump the `<major version>`. Otherwise, you can simply replace the existing schema by uploading using the same tag. |