Implement quick connect in device agent

[Steve-Mcl]

Description

• Support new args for initialising setup from CLI using a one time code
  • -o/--otc - One Time Code
  • -u/--ff-url - URL of FlowFuse platform to connect and spend the OTC
• Updates to README.md to document new args
• Adds test "Agent Manager should request config from FlowFuse when started in Quick Connect mode"

Examples

flowfuse-device-agent -o free-pond-grouse -u https:app.my-ff.org

[AGENT] 29/01/2024 15:51:56 [info] Entering Device setup...
[AGENT] 29/01/2024 15:51:56 [info] Device setup was successful
[AGENT] 29/01/2024 15:51:56 [info] To start the Device Agent with the new configuration run the following command:
[AGENT] 29/01/2024 15:51:56 [info] flowfuse-device-agent

2nd run: flowfuse-device-agent -o free-pond-grouse -u https:app.my-ff.org

[AGENT] 30/01/2024 09:00:50 [info] Entering Device setup...
[AGENT] 30/01/2024 09:00:50 [warn] Problem encountered during provisioning: HTTPError: Response code 401 (Unauthorized)
[AGENT] 30/01/2024 09:00:50 [warn] Device setup was unsuccessful

flowfuse-device-agent -o red-horse-velvet -u https:app.my-ff.org -d c:/opt/dev1

[AGENT] 29/01/2024 15:51:56 [info] Entering Device setup...
[AGENT] 29/01/2024 15:51:56 [info] Device setup was successful
[AGENT] 29/01/2024 15:51:56 [info] To start the Device Agent with the new configuration run the following command:
[AGENT] 29/01/2024 15:51:56 [info] flowfuse-device-agent -d c:/opt/dev1

flowfuse-device-agent -u https:app.my-ff.org -d c:/opt/dev1

[AGENT] 30/01/2024 09:01:53 [warn] Device setup requires parameter --otc to be 8 or more characters

flowfuse-device-agent -o free-pond-grouse

[AGENT] 30/01/2024 09:02:54 [warn] Device setup requires parameter --ff-url to be set

Prior to redesign 29-001-2024

* Support new args for Quick Connect * `-q/--qc` - boolean flag to init Quick Connect * `-o/--otc` - One Time Code * `-u/--ff-url` - URL of FlowFuse platform to connect and spend the OTC * Updates to README.md to document new args * Adds test "Agent Manager should request config from FlowFuse when started in Quick Connect mode"

Related Issue(s)

#3256

Checklist

• [x] I have read the contribution guidelines
• [x] Suitable unit/system level tests have been added and they pass
• [x] Documentation has been updated
  • [ ] Upgrade instructions
  • [x] Configuration details
  • [ ] Concepts
• [ ] Changes flowforge.yml?
  • [ ] Issue/PR raised on FlowFuse/helm to update ConfigMap Template
  • [ ] Issue/PR raised on FlowFuse/CloudProject to update values for Staging/Production

Labels

• [ ] Backport needed? -> add the backport label
• [ ] Includes a DB migration? -> add the area:migration label

[Steve-Mcl]

Converted to draft while requested redesign is carried out