Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: Expand section on Provision Watchers (#598) #865

Merged
merged 1 commit into from
Sep 22, 2022

Conversation

iain-anderson
Copy link
Member

If your build fails due to your commit message not passing the build checks, please review the guidelines here: https://github.com/edgexfoundry/edgex-docs/blob/main/.github/Contributing.md

PR Checklist

Please check if your PR fulfills the following requirements:

  • Changes have been rendered and validated locally using mkdocs-material (see edgex-docs README)


A Provision Watcher is a filter which is applied to any new devices found when a device service scans for devices. It contains a set of ProtocolProperty names and values, these values may be regular expressions. If a new device is to be added, each of these must match the corresponding properties of the new device. Furthermore, a provision watcher may also contain “blocking” identifiers, if any of these match the properties of the new device (note that matching here is *not* regex-based), the device will not be automatically provisioned. This allows the scope of a device scan to be narrowed or allow specific devices to be avoided.

More than one Provision Watcher may be provided for a device service, and discovered devices are added if they match with any one of them. In addition to the filtering criteria, a Provision Watcher includes specification of various properties to be associated with the new device which matches it: these are the Profile name, the initial AdminState, and optionally any AutoEvents to be applied.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is all a good improvement.
One question: since the profile contains AutoEvents, what would be an example reason to include them in the PW?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@TomBrennan-Eaton the profile doesn't contain AutoEvents :)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

D'oh - right, this is like devices.toml entries.

@TomBrennan-Eaton TomBrennan-Eaton self-requested a review September 22, 2022 14:35
@iain-anderson iain-anderson merged commit 4c1f171 into edgexfoundry:main Sep 22, 2022
@iain-anderson iain-anderson deleted the issue-598 branch September 22, 2022 14:51
edgex-jenkins added a commit that referenced this pull request Sep 22, 2022
TomBrennan-Eaton pushed a commit to TomBrennan-Eaton/edgex-docs that referenced this pull request Sep 26, 2022
TomBrennan-Eaton added a commit to TomBrennan-Eaton/edgex-docs that referenced this pull request Sep 27, 2022
Noted that, for local builds, now also must have pip install
mkdocs-macros-plugin>=0.5

mkdocs now reports that Line 267 of some unamed .md file has:
INFO     -  [macros] - ERROR # _Macro Syntax Error_
            _Line 267 in Markdown file:_ **expected token ':', got '}'**

Signed-off-by: Tom Brennan <[email protected]>

Update based on review comments.

In particular, added example and requirements to extend Provisioning
for south-bound Device Services.

Removed 0004- from the UCR filename.

Signed-off-by: Tom Brennan <[email protected]>

Updates based on discussion today, reviewing this UCR.

Renamed the UCR for clarity; emphasizing Device Metadata.

Dropped minor correction in README.md

Signed-off-by: Tom Brennan <[email protected]>

ci: add retry to mkdocs build stage

Signed-off-by: Ernesto Ojeda <[email protected]>

feat(microservices): Add NATS MessageBus Overview

Lists new options, build flag and simple jetstream example.  Links to
README for complete option listing.

Signed-off-by: Alex Ullrich <[email protected]>

doc: updated the SDK-Go-API.md document to reflect the new functions of DeviceSDKService wrapper

Signed-off-by: Marc-Philippe Fuller <[email protected]>

fix: Remove scheduler unused fields and update data dictionary

fix edgexfoundry#787

Signed-off-by: Ginny Guan <[email protected]>

fix: Escape unintended macro templates, fail docs build on errors (edgexfoundry#814)

* fix: Escape marching Jinja test in CLI docs

* feat: Make builds fail on macro errors

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: add build and run on ARM32

fixes edgexfoundry#685

Signed-off-by: jpwhitemn <[email protected]>

feat: add arm32 doc to nav bar

Signed-off-by: jpwhitemn <[email protected]>

feat: Referencing doc pages with latest alias (edgexfoundry#831)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

Co-authored-by: Mengyi Wang <[email protected]>

feat: Document Core Metadata Device System Events

closes edgexfoundry#829

Signed-off-by: Leonard Goodell <[email protected]>

fix: Rename the existing UCR to not have leading sequence number (edgexfoundry#837)

* fix: Rename the existing UCR to not have leading sequence number

Also added notes to TOC on naming and order of UCRs and ADRs

Signed-off-by: Lenny Goodell <[email protected]>
Co-authored-by: Tom Brennan <[email protected]>

docs: Update MQTT example doc

Update MQTT example doc for Levski release

Close edgexfoundry#64

Signed-off-by: bruce <[email protected]>

feat: document core metadata units of measure capability

Signed-off-by: Chris Hung <[email protected]>

fix: Add kong restart step to use new admin token after re-setup

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

fix: Correct spelling of autostart option

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: update uom configuration example

Signed-off-by: Chris Hung <[email protected]>

feat(microservices): Reading AES256 Protected Data

Add note on decrypting payloads protected with AESProtection.  Include
python code from TAF as an example.

Fixes edgexfoundry#784

Signed-off-by: Alex Ullrich <[email protected]>

feat: Document Core Metadata Device System Events

closes edgexfoundry#829

Signed-off-by: Leonard Goodell <[email protected]>
Co-authored-by: Tom Brennan <[email protected]>

feat: document core metadata units of measure capability

Signed-off-by: Chris Hung <[email protected]>
Co-authored-by: Tom Brennan <[email protected]>

feat: update uom configuration example

Signed-off-by: Chris Hung <[email protected]>

fix: Change snap getting started to use consul management token (edgexfoundry#841)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

docs: add management token (edgexfoundry#844)

close #3158

Signed-off-by: Valina Li <[email protected]>

Signed-off-by: Valina Li <[email protected]>

Update docs_src/design/ucr/Provision-Watch-via-Device-Metadata.md

Signed-off-by: Tom Brennan <[email protected]>
Co-authored-by: Farshid Tavakolizadeh <[email protected]>

Updates per review comments.

Signed-off-by: Tom Brennan <[email protected]>

ci: add retry to mkdocs build stage

Signed-off-by: Ernesto Ojeda <[email protected]>

feat(microservices): Add NATS MessageBus Overview

Lists new options, build flag and simple jetstream example.  Links to
README for complete option listing.

Signed-off-by: Alex Ullrich <[email protected]>

doc: updated the SDK-Go-API.md document to reflect the new functions of DeviceSDKService wrapper

Signed-off-by: Marc-Philippe Fuller <[email protected]>

fix: Remove scheduler unused fields and update data dictionary

fix edgexfoundry#787

Signed-off-by: Ginny Guan <[email protected]>

fix: Escape unintended macro templates, fail docs build on errors (edgexfoundry#814)

* fix: Escape marching Jinja test in CLI docs

* feat: Make builds fail on macro errors

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: add build and run on ARM32

fixes edgexfoundry#685

Signed-off-by: jpwhitemn <[email protected]>

feat: add arm32 doc to nav bar

Signed-off-by: jpwhitemn <[email protected]>

feat: Referencing doc pages with latest alias (edgexfoundry#831)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

Co-authored-by: Mengyi Wang <[email protected]>

docs: Update MQTT example doc

Update MQTT example doc for Levski release

Close edgexfoundry#64

Signed-off-by: bruce <[email protected]>

feat: document core metadata units of measure capability

Signed-off-by: Chris Hung <[email protected]>

fix: Add kong restart step to use new admin token after re-setup

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

fix: Correct spelling of autostart option

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: update uom configuration example

Signed-off-by: Chris Hung <[email protected]>

feat(microservices): Reading AES256 Protected Data

Add note on decrypting payloads protected with AESProtection.  Include
python code from TAF as an example.

Fixes edgexfoundry#784

Signed-off-by: Alex Ullrich <[email protected]>

fix: Change snap getting started to use consul management token (edgexfoundry#841)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

docs: add management token (edgexfoundry#844)

close #3158

Signed-off-by: Valina Li <[email protected]>

Signed-off-by: Valina Li <[email protected]>

feat: Add documentation of the EdgeX MessageBus

closes edgexfoundry#744, edgexfoundry#808

Signed-off-by: Leonard Goodell <[email protected]>

feat: Document NATS MessageBus Option

Add notes on NATS MessageBus implementation.

Signed-off-by: Alex Ullrich <[email protected]>
Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed 1st round of PR feedback

Signed-off-by: Leonard Goodell <[email protected]>

Update Ch-Metadata.md and TOC.

Restored missing line.

Fixing up lousy github signoff snafu:

Signed-off-by: Tom Brennan <[email protected]>

docs: add warning to GettingStartedusingDocker.md

Signed-off-by: melody <[email protected]>

fix: Correct relative link to snap configuration (edgexfoundry#852)

Signed-off-by: Mengyi Wang <[email protected]>

fix: Fix broken link to docker compose install

Docker seems to be actively updating their Compose documention, so the previous link
is no longer valid.

Signed-off-by: Leonard Goodell <[email protected]>

feat: Create Record and Replay UCR

related to edgexfoundry#471

Signed-off-by: Leonard Goodell <[email protected]>

fix: Renamed UCR without a sequence number

Signed-off-by: Leonard Goodell <[email protected]>

feat: Added requirements for capturing of Device/Device profiles

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed PR feedback, restructured & added new requirments

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed PR feedback for GZIP and timestamp requirment

Signed-off-by: Leonard Goodell <[email protected]>

feat: Changed status to Approved

Signed-off-by: Leonard Goodell <[email protected]>

refactor: [main] Rework device service list and add new camera device services

closes edgexfoundry#850

Signed-off-by: Leonard Goodell <[email protected]>

feat: Document the SecretProvider API for app and device services

closes edgexfoundry#847

Signed-off-by: Leonard Goodell <[email protected]>

fix: Correct typo in CommandClient function description

Signed-off-by: Leonard Goodell <[email protected]>

feat: Create UCR for Parent-Child Device Relationships

Signed-off-by: Tom Brennan [email protected]

If your build fails due to your commit message not passing
the build checks, please review the guidelines here: https://github.com/edgexfoundry/edgex-docs/blob/main/.github/Contributing.md

PR Checklist
Please check if your PR fulfills the following requirements:

 Changes have been rendered and validated locally using mkdocs-material
(see edgex-docs README)

Signed-off-by: Tom Brennan <[email protected]>

Fixed the URL complaint/validation failure and added link to this PR.

The failure was probably due to CORS since the previous RFC address
is forwarded to this new one.

Added another Use Case extension.

Updated the README for the "local" process to validate and run the
mkdocs server, based on my experience.

Signed-off-by: Tom Brennan <[email protected]>

Added a separate UCR (edgexfoundry#3) for "Extending" Device Data, since it may end up

related.

Removed implementation stuff from edgexfoundry#2, and added requirements,
per review comments.
Added a Use Case extension for "gateway of gateways".

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Updates based on review comments.

Removed the second UCR from this PR.
Renamed to remove the 0002 from the filename.

Signed-off-by: Tom Brennan <[email protected]>

feat: Create System Events ADR

closes edgexfoundry#581

Signed-off-by: Leonard Goodell <[email protected]>

feat: Addressed PR feedback from Cloud

Signed-off-by: Leonard Goodell <[email protected]>

fix: Corrected the TOC description for the ADR

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed typos and wording from PR reviews

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed PR feeback

- Changed Publish Topic Prifix to be in configuration
- Clarified standard topic level vs addition levels for specific use
cases
- Fixed typos.

Signed-off-by: Leonard Goodell <[email protected]>

fix: Changed to use {PublishTopicPrefix} in topic definition

Signed-off-by: Leonard Goodell <[email protected]>

feat: Updated status to approved

Signed-off-by: Leonard Goodell <[email protected]>

ci: add retry to mkdocs build stage

Signed-off-by: Ernesto Ojeda <[email protected]>

Updated based on group discussion of this UCR. Primarily updated the

requirements section, absolving core services from entanglements in this
feature.

Signed-off-by: Tom Brennan <[email protected]>

Updated per review comment, putting burden on core-metadata to remove

child devices when the parent is removed.

Reverted extraneous suggestion in README.md

Signed-off-by: Tom Brennan <[email protected]>

One more thing to revert in README.md

Signed-off-by: Tom Brennan <[email protected]>

feat: Expand section on Provision Watchers (edgexfoundry#598) (edgexfoundry#865)

Signed-off-by: Iain Anderson <[email protected]>

docs: added usb camera streaming guide

Signed-off-by: brianointel <[email protected]>

docs: pr updates

Signed-off-by: brianointel <[email protected]>

docs: updated to use mplayer

Signed-off-by: brianointel <[email protected]>

Update docs_src/examples/Ch-ExamplesUsbDeviceService.md

Co-authored-by: Anthony Casagrande <[email protected]>
Signed-off-by: brianointel <[email protected]>

docs: pr updates

Signed-off-by: brianointel <[email protected]>

docs: pr updates

Signed-off-by: Brian Osburn <[email protected]>

docs: removed link

Signed-off-by: Brian Osburn <[email protected]>

docs: updated formatting

Signed-off-by: Brian Osburn <[email protected]>

docs: updated wording

Signed-off-by: Brian Osburn <[email protected]>

docs: updated capabilities

Signed-off-by: brianointel <[email protected]>
TomBrennan-Eaton added a commit to TomBrennan-Eaton/edgex-docs that referenced this pull request Sep 27, 2022
Noted that, for local builds, now also must have pip install
mkdocs-macros-plugin>=0.5

mkdocs now reports that Line 267 of some unamed .md file has:
INFO     -  [macros] - ERROR # _Macro Syntax Error_
            _Line 267 in Markdown file:_ **expected token ':', got '}'**

Signed-off-by: Tom Brennan <[email protected]>

Update based on review comments.

In particular, added example and requirements to extend Provisioning
for south-bound Device Services.

Removed 0004- from the UCR filename.

Signed-off-by: Tom Brennan <[email protected]>

Updates based on discussion today, reviewing this UCR.

Renamed the UCR for clarity; emphasizing Device Metadata.

Dropped minor correction in README.md

Signed-off-by: Tom Brennan <[email protected]>

ci: add retry to mkdocs build stage

Signed-off-by: Ernesto Ojeda <[email protected]>

feat(microservices): Add NATS MessageBus Overview

Lists new options, build flag and simple jetstream example.  Links to
README for complete option listing.

Signed-off-by: Alex Ullrich <[email protected]>

doc: updated the SDK-Go-API.md document to reflect the new functions of DeviceSDKService wrapper

Signed-off-by: Marc-Philippe Fuller <[email protected]>

fix: Remove scheduler unused fields and update data dictionary

fix edgexfoundry#787

Signed-off-by: Ginny Guan <[email protected]>

fix: Escape unintended macro templates, fail docs build on errors (edgexfoundry#814)

* fix: Escape marching Jinja test in CLI docs

* feat: Make builds fail on macro errors

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: add build and run on ARM32

fixes edgexfoundry#685

Signed-off-by: jpwhitemn <[email protected]>

feat: add arm32 doc to nav bar

Signed-off-by: jpwhitemn <[email protected]>

feat: Referencing doc pages with latest alias (edgexfoundry#831)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

Co-authored-by: Mengyi Wang <[email protected]>

feat: Document Core Metadata Device System Events

closes edgexfoundry#829

Signed-off-by: Leonard Goodell <[email protected]>

fix: Rename the existing UCR to not have leading sequence number (edgexfoundry#837)

* fix: Rename the existing UCR to not have leading sequence number

Also added notes to TOC on naming and order of UCRs and ADRs

Signed-off-by: Lenny Goodell <[email protected]>
Co-authored-by: Tom Brennan <[email protected]>

docs: Update MQTT example doc

Update MQTT example doc for Levski release

Close edgexfoundry#64

Signed-off-by: bruce <[email protected]>

feat: document core metadata units of measure capability

Signed-off-by: Chris Hung <[email protected]>

fix: Add kong restart step to use new admin token after re-setup

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

fix: Correct spelling of autostart option

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: update uom configuration example

Signed-off-by: Chris Hung <[email protected]>

feat(microservices): Reading AES256 Protected Data

Add note on decrypting payloads protected with AESProtection.  Include
python code from TAF as an example.

Fixes edgexfoundry#784

Signed-off-by: Alex Ullrich <[email protected]>

feat: Document Core Metadata Device System Events

closes edgexfoundry#829

Signed-off-by: Leonard Goodell <[email protected]>
Co-authored-by: Tom Brennan <[email protected]>

feat: document core metadata units of measure capability

Signed-off-by: Chris Hung <[email protected]>
Co-authored-by: Tom Brennan <[email protected]>

feat: update uom configuration example

Signed-off-by: Chris Hung <[email protected]>

fix: Change snap getting started to use consul management token (edgexfoundry#841)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

docs: add management token (edgexfoundry#844)

close #3158

Signed-off-by: Valina Li <[email protected]>

Signed-off-by: Valina Li <[email protected]>

Update docs_src/design/ucr/Provision-Watch-via-Device-Metadata.md

Signed-off-by: Tom Brennan <[email protected]>
Co-authored-by: Farshid Tavakolizadeh <[email protected]>

Updates per review comments.

Signed-off-by: Tom Brennan <[email protected]>

ci: add retry to mkdocs build stage

Signed-off-by: Ernesto Ojeda <[email protected]>

feat(microservices): Add NATS MessageBus Overview

Lists new options, build flag and simple jetstream example.  Links to
README for complete option listing.

Signed-off-by: Alex Ullrich <[email protected]>

doc: updated the SDK-Go-API.md document to reflect the new functions of DeviceSDKService wrapper

Signed-off-by: Marc-Philippe Fuller <[email protected]>

fix: Remove scheduler unused fields and update data dictionary

fix edgexfoundry#787

Signed-off-by: Ginny Guan <[email protected]>

fix: Escape unintended macro templates, fail docs build on errors (edgexfoundry#814)

* fix: Escape marching Jinja test in CLI docs

* feat: Make builds fail on macro errors

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: add build and run on ARM32

fixes edgexfoundry#685

Signed-off-by: jpwhitemn <[email protected]>

feat: add arm32 doc to nav bar

Signed-off-by: jpwhitemn <[email protected]>

feat: Referencing doc pages with latest alias (edgexfoundry#831)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

Co-authored-by: Mengyi Wang <[email protected]>

docs: Update MQTT example doc

Update MQTT example doc for Levski release

Close edgexfoundry#64

Signed-off-by: bruce <[email protected]>

feat: document core metadata units of measure capability

Signed-off-by: Chris Hung <[email protected]>

fix: Add kong restart step to use new admin token after re-setup

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

fix: Correct spelling of autostart option

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: update uom configuration example

Signed-off-by: Chris Hung <[email protected]>

feat(microservices): Reading AES256 Protected Data

Add note on decrypting payloads protected with AESProtection.  Include
python code from TAF as an example.

Fixes edgexfoundry#784

Signed-off-by: Alex Ullrich <[email protected]>

fix: Change snap getting started to use consul management token (edgexfoundry#841)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

docs: add management token (edgexfoundry#844)

close #3158

Signed-off-by: Valina Li <[email protected]>

Signed-off-by: Valina Li <[email protected]>

feat: Add documentation of the EdgeX MessageBus

closes edgexfoundry#744, edgexfoundry#808

Signed-off-by: Leonard Goodell <[email protected]>

feat: Document NATS MessageBus Option

Add notes on NATS MessageBus implementation.

Signed-off-by: Alex Ullrich <[email protected]>
Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed 1st round of PR feedback

Signed-off-by: Leonard Goodell <[email protected]>

Update Ch-Metadata.md and TOC.

Restored missing line.

Fixing up lousy github signoff snafu:

Signed-off-by: Tom Brennan <[email protected]>

docs: add warning to GettingStartedusingDocker.md

Signed-off-by: melody <[email protected]>

fix: Correct relative link to snap configuration (edgexfoundry#852)

Signed-off-by: Mengyi Wang <[email protected]>

fix: Fix broken link to docker compose install

Docker seems to be actively updating their Compose documention, so the previous link
is no longer valid.

Signed-off-by: Leonard Goodell <[email protected]>

feat: Create Record and Replay UCR

related to edgexfoundry#471

Signed-off-by: Leonard Goodell <[email protected]>

fix: Renamed UCR without a sequence number

Signed-off-by: Leonard Goodell <[email protected]>

feat: Added requirements for capturing of Device/Device profiles

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed PR feedback, restructured & added new requirments

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed PR feedback for GZIP and timestamp requirment

Signed-off-by: Leonard Goodell <[email protected]>

feat: Changed status to Approved

Signed-off-by: Leonard Goodell <[email protected]>

refactor: [main] Rework device service list and add new camera device services

closes edgexfoundry#850

Signed-off-by: Leonard Goodell <[email protected]>

feat: Document the SecretProvider API for app and device services

closes edgexfoundry#847

Signed-off-by: Leonard Goodell <[email protected]>

fix: Correct typo in CommandClient function description

Signed-off-by: Leonard Goodell <[email protected]>

feat: Create UCR for Parent-Child Device Relationships

Signed-off-by: Tom Brennan [email protected]

If your build fails due to your commit message not passing
the build checks, please review the guidelines here: https://github.com/edgexfoundry/edgex-docs/blob/main/.github/Contributing.md

PR Checklist
Please check if your PR fulfills the following requirements:

 Changes have been rendered and validated locally using mkdocs-material
(see edgex-docs README)

Signed-off-by: Tom Brennan <[email protected]>

Fixed the URL complaint/validation failure and added link to this PR.

The failure was probably due to CORS since the previous RFC address
is forwarded to this new one.

Added another Use Case extension.

Updated the README for the "local" process to validate and run the
mkdocs server, based on my experience.

Signed-off-by: Tom Brennan <[email protected]>

Added a separate UCR (edgexfoundry#3) for "Extending" Device Data, since it may end up

related.

Removed implementation stuff from edgexfoundry#2, and added requirements,
per review comments.
Added a Use Case extension for "gateway of gateways".

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Updates based on review comments.

Removed the second UCR from this PR.
Renamed to remove the 0002 from the filename.

Signed-off-by: Tom Brennan <[email protected]>

feat: Create System Events ADR

closes edgexfoundry#581

Signed-off-by: Leonard Goodell <[email protected]>

feat: Addressed PR feedback from Cloud

Signed-off-by: Leonard Goodell <[email protected]>

fix: Corrected the TOC description for the ADR

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed typos and wording from PR reviews

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed PR feeback

- Changed Publish Topic Prifix to be in configuration
- Clarified standard topic level vs addition levels for specific use
cases
- Fixed typos.

Signed-off-by: Leonard Goodell <[email protected]>

fix: Changed to use {PublishTopicPrefix} in topic definition

Signed-off-by: Leonard Goodell <[email protected]>

feat: Updated status to approved

Signed-off-by: Leonard Goodell <[email protected]>

ci: add retry to mkdocs build stage

Signed-off-by: Ernesto Ojeda <[email protected]>

Updated based on group discussion of this UCR. Primarily updated the

requirements section, absolving core services from entanglements in this
feature.

Signed-off-by: Tom Brennan <[email protected]>

Updated per review comment, putting burden on core-metadata to remove

child devices when the parent is removed.

Reverted extraneous suggestion in README.md

Signed-off-by: Tom Brennan <[email protected]>

One more thing to revert in README.md

Signed-off-by: Tom Brennan <[email protected]>

feat: Expand section on Provision Watchers (edgexfoundry#598) (edgexfoundry#865)

Signed-off-by: Iain Anderson <[email protected]>

docs: added usb camera streaming guide

Signed-off-by: brianointel <[email protected]>

docs: pr updates

Signed-off-by: brianointel <[email protected]>

docs: updated to use mplayer

Signed-off-by: brianointel <[email protected]>

Update docs_src/examples/Ch-ExamplesUsbDeviceService.md

Co-authored-by: Anthony Casagrande <[email protected]>
Signed-off-by: brianointel <[email protected]>

docs: pr updates

Signed-off-by: brianointel <[email protected]>

docs: pr updates

Signed-off-by: Brian Osburn <[email protected]>

docs: removed link

Signed-off-by: Brian Osburn <[email protected]>

docs: updated formatting

Signed-off-by: Brian Osburn <[email protected]>

docs: updated wording

Signed-off-by: Brian Osburn <[email protected]>

docs: updated capabilities

Signed-off-by: brianointel <[email protected]>
TomBrennan-Eaton added a commit to TomBrennan-Eaton/edgex-docs that referenced this pull request Sep 27, 2022
Noted that, for local builds, now also must have pip install
mkdocs-macros-plugin>=0.5

mkdocs now reports that Line 267 of some unamed .md file has:
INFO     -  [macros] - ERROR # _Macro Syntax Error_
            _Line 267 in Markdown file:_ **expected token ':', got '}'**

Signed-off-by: Tom Brennan <[email protected]>

Update based on review comments.

In particular, added example and requirements to extend Provisioning
for south-bound Device Services.

Removed 0004- from the UCR filename.

Signed-off-by: Tom Brennan <[email protected]>

Updates based on discussion today, reviewing this UCR.

Renamed the UCR for clarity; emphasizing Device Metadata.

Dropped minor correction in README.md

Signed-off-by: Tom Brennan <[email protected]>

ci: add retry to mkdocs build stage

Signed-off-by: Ernesto Ojeda <[email protected]>

feat(microservices): Add NATS MessageBus Overview

Lists new options, build flag and simple jetstream example.  Links to
README for complete option listing.

Signed-off-by: Alex Ullrich <[email protected]>

doc: updated the SDK-Go-API.md document to reflect the new functions of DeviceSDKService wrapper

Signed-off-by: Marc-Philippe Fuller <[email protected]>

fix: Remove scheduler unused fields and update data dictionary

fix edgexfoundry#787

Signed-off-by: Ginny Guan <[email protected]>

fix: Escape unintended macro templates, fail docs build on errors (edgexfoundry#814)

* fix: Escape marching Jinja test in CLI docs

* feat: Make builds fail on macro errors

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: add build and run on ARM32

fixes edgexfoundry#685

Signed-off-by: jpwhitemn <[email protected]>

feat: add arm32 doc to nav bar

Signed-off-by: jpwhitemn <[email protected]>

feat: Referencing doc pages with latest alias (edgexfoundry#831)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

Co-authored-by: Mengyi Wang <[email protected]>

feat: Document Core Metadata Device System Events

closes edgexfoundry#829

Signed-off-by: Leonard Goodell <[email protected]>

fix: Rename the existing UCR to not have leading sequence number (edgexfoundry#837)

* fix: Rename the existing UCR to not have leading sequence number

Also added notes to TOC on naming and order of UCRs and ADRs

Signed-off-by: Lenny Goodell <[email protected]>
Co-authored-by: Tom Brennan <[email protected]>

docs: Update MQTT example doc

Update MQTT example doc for Levski release

Close edgexfoundry#64

Signed-off-by: bruce <[email protected]>

feat: document core metadata units of measure capability

Signed-off-by: Chris Hung <[email protected]>

fix: Add kong restart step to use new admin token after re-setup

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

fix: Correct spelling of autostart option

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: update uom configuration example

Signed-off-by: Chris Hung <[email protected]>

feat(microservices): Reading AES256 Protected Data

Add note on decrypting payloads protected with AESProtection.  Include
python code from TAF as an example.

Fixes edgexfoundry#784

Signed-off-by: Alex Ullrich <[email protected]>

feat: Document Core Metadata Device System Events

closes edgexfoundry#829

Signed-off-by: Leonard Goodell <[email protected]>
Co-authored-by: Tom Brennan <[email protected]>

feat: document core metadata units of measure capability

Signed-off-by: Chris Hung <[email protected]>
Co-authored-by: Tom Brennan <[email protected]>

feat: update uom configuration example

Signed-off-by: Chris Hung <[email protected]>

fix: Change snap getting started to use consul management token (edgexfoundry#841)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

docs: add management token (edgexfoundry#844)

close #3158

Signed-off-by: Valina Li <[email protected]>

Signed-off-by: Valina Li <[email protected]>

Update docs_src/design/ucr/Provision-Watch-via-Device-Metadata.md

Signed-off-by: Tom Brennan <[email protected]>
Co-authored-by: Farshid Tavakolizadeh <[email protected]>

Updates per review comments.

Signed-off-by: Tom Brennan <[email protected]>

ci: add retry to mkdocs build stage

Signed-off-by: Ernesto Ojeda <[email protected]>

feat(microservices): Add NATS MessageBus Overview

Lists new options, build flag and simple jetstream example.  Links to
README for complete option listing.

Signed-off-by: Alex Ullrich <[email protected]>

doc: updated the SDK-Go-API.md document to reflect the new functions of DeviceSDKService wrapper

Signed-off-by: Marc-Philippe Fuller <[email protected]>

fix: Remove scheduler unused fields and update data dictionary

fix edgexfoundry#787

Signed-off-by: Ginny Guan <[email protected]>

fix: Escape unintended macro templates, fail docs build on errors (edgexfoundry#814)

* fix: Escape marching Jinja test in CLI docs

* feat: Make builds fail on macro errors

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: add build and run on ARM32

fixes edgexfoundry#685

Signed-off-by: jpwhitemn <[email protected]>

feat: add arm32 doc to nav bar

Signed-off-by: jpwhitemn <[email protected]>

feat: Referencing doc pages with latest alias (edgexfoundry#831)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

Co-authored-by: Mengyi Wang <[email protected]>

docs: Update MQTT example doc

Update MQTT example doc for Levski release

Close edgexfoundry#64

Signed-off-by: bruce <[email protected]>

feat: document core metadata units of measure capability

Signed-off-by: Chris Hung <[email protected]>

fix: Add kong restart step to use new admin token after re-setup

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

fix: Correct spelling of autostart option

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

feat: update uom configuration example

Signed-off-by: Chris Hung <[email protected]>

feat(microservices): Reading AES256 Protected Data

Add note on decrypting payloads protected with AESProtection.  Include
python code from TAF as an example.

Fixes edgexfoundry#784

Signed-off-by: Alex Ullrich <[email protected]>

fix: Change snap getting started to use consul management token (edgexfoundry#841)

Signed-off-by: Farshid Tavakolizadeh <[email protected]>

docs: add management token (edgexfoundry#844)

close #3158

Signed-off-by: Valina Li <[email protected]>

Signed-off-by: Valina Li <[email protected]>

feat: Add documentation of the EdgeX MessageBus

closes edgexfoundry#744, edgexfoundry#808

Signed-off-by: Leonard Goodell <[email protected]>

feat: Document NATS MessageBus Option

Add notes on NATS MessageBus implementation.

Signed-off-by: Alex Ullrich <[email protected]>
Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed 1st round of PR feedback

Signed-off-by: Leonard Goodell <[email protected]>

Update Ch-Metadata.md and TOC.

Restored missing line.

Fixing up lousy github signoff snafu:

Signed-off-by: Tom Brennan <[email protected]>

docs: add warning to GettingStartedusingDocker.md

Signed-off-by: melody <[email protected]>

fix: Correct relative link to snap configuration (edgexfoundry#852)

Signed-off-by: Mengyi Wang <[email protected]>

fix: Fix broken link to docker compose install

Docker seems to be actively updating their Compose documention, so the previous link
is no longer valid.

Signed-off-by: Leonard Goodell <[email protected]>

feat: Create Record and Replay UCR

related to edgexfoundry#471

Signed-off-by: Leonard Goodell <[email protected]>

fix: Renamed UCR without a sequence number

Signed-off-by: Leonard Goodell <[email protected]>

feat: Added requirements for capturing of Device/Device profiles

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed PR feedback, restructured & added new requirments

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed PR feedback for GZIP and timestamp requirment

Signed-off-by: Leonard Goodell <[email protected]>

feat: Changed status to Approved

Signed-off-by: Leonard Goodell <[email protected]>

refactor: [main] Rework device service list and add new camera device services

closes edgexfoundry#850

Signed-off-by: Leonard Goodell <[email protected]>

feat: Document the SecretProvider API for app and device services

closes edgexfoundry#847

Signed-off-by: Leonard Goodell <[email protected]>

fix: Correct typo in CommandClient function description

Signed-off-by: Leonard Goodell <[email protected]>

feat: Create UCR for Parent-Child Device Relationships

Signed-off-by: Tom Brennan [email protected]

If your build fails due to your commit message not passing
the build checks, please review the guidelines here: https://github.com/edgexfoundry/edgex-docs/blob/main/.github/Contributing.md

PR Checklist
Please check if your PR fulfills the following requirements:

 Changes have been rendered and validated locally using mkdocs-material
(see edgex-docs README)

Signed-off-by: Tom Brennan <[email protected]>

Fixed the URL complaint/validation failure and added link to this PR.

The failure was probably due to CORS since the previous RFC address
is forwarded to this new one.

Added another Use Case extension.

Updated the README for the "local" process to validate and run the
mkdocs server, based on my experience.

Signed-off-by: Tom Brennan <[email protected]>

Added a separate UCR (edgexfoundry#3) for "Extending" Device Data, since it may end up

related.

Removed implementation stuff from edgexfoundry#2, and added requirements,
per review comments.
Added a Use Case extension for "gateway of gateways".

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Update docs_src/design/ucr/0002-Device-Parent-Child-Relationships.md

Signed-off-by: Tom Brennan <[email protected]>

Updates based on review comments.

Removed the second UCR from this PR.
Renamed to remove the 0002 from the filename.

Signed-off-by: Tom Brennan <[email protected]>

feat: Create System Events ADR

closes edgexfoundry#581

Signed-off-by: Leonard Goodell <[email protected]>

feat: Addressed PR feedback from Cloud

Signed-off-by: Leonard Goodell <[email protected]>

fix: Corrected the TOC description for the ADR

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed typos and wording from PR reviews

Signed-off-by: Leonard Goodell <[email protected]>

fix: Addressed PR feeback

- Changed Publish Topic Prifix to be in configuration
- Clarified standard topic level vs addition levels for specific use
cases
- Fixed typos.

Signed-off-by: Leonard Goodell <[email protected]>

fix: Changed to use {PublishTopicPrefix} in topic definition

Signed-off-by: Leonard Goodell <[email protected]>

feat: Updated status to approved

Signed-off-by: Leonard Goodell <[email protected]>

ci: add retry to mkdocs build stage

Signed-off-by: Ernesto Ojeda <[email protected]>

Updated based on group discussion of this UCR. Primarily updated the

requirements section, absolving core services from entanglements in this
feature.

Signed-off-by: Tom Brennan <[email protected]>

Updated per review comment, putting burden on core-metadata to remove

child devices when the parent is removed.

Reverted extraneous suggestion in README.md

Signed-off-by: Tom Brennan <[email protected]>

One more thing to revert in README.md

Signed-off-by: Tom Brennan <[email protected]>

feat: Expand section on Provision Watchers (edgexfoundry#598) (edgexfoundry#865)

Signed-off-by: Iain Anderson <[email protected]>

docs: added usb camera streaming guide

Signed-off-by: brianointel <[email protected]>

docs: pr updates

Signed-off-by: brianointel <[email protected]>

docs: updated to use mplayer

Signed-off-by: brianointel <[email protected]>

Update docs_src/examples/Ch-ExamplesUsbDeviceService.md

Co-authored-by: Anthony Casagrande <[email protected]>
Signed-off-by: brianointel <[email protected]>

docs: pr updates

Signed-off-by: brianointel <[email protected]>

docs: pr updates

Signed-off-by: Brian Osburn <[email protected]>

docs: removed link

Signed-off-by: Brian Osburn <[email protected]>

docs: updated formatting

Signed-off-by: Brian Osburn <[email protected]>

docs: updated wording

Signed-off-by: Brian Osburn <[email protected]>

docs: updated capabilities

Signed-off-by: brianointel <[email protected]>
TomBrennan-Eaton pushed a commit to TomBrennan-Eaton/edgex-docs that referenced this pull request Sep 27, 2022
TomBrennan-Eaton pushed a commit to TomBrennan-Eaton/edgex-docs that referenced this pull request Sep 27, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants