Container Registration Testing (test)

Use test when you want an explicit registration validation run against a mock config-hub.

Command

npx worker-cli test <worker-dir> <image-name>

Example:

npx worker-cli test ./workers/opc-reader registry.example.com/myteam/opc-reader:1.4.2

What happens

1. Starts local mock hub HTTP service.
2. Runs your container with test runtime env vars.
3. Waits for worker registration payloads.
4. Reads registration box versions.
5. Fails if versions differ from worker project version.

Key tuning variables

CONFIG_HUB_MOCK_PORT=3120
MOCK_HUB_HOST_IP=172.17.0.1
TIMEOUT=60

Troubleshooting example

If a worker never registers:

# try explicit host IP and longer timeout
MOCK_HUB_HOST_IP=172.17.0.1 TIMEOUT=90 npx worker-cli test ./workers/opc-reader registry.example.com/myteam/opc-reader:1.4.2

[NOTE!lightbulb/ROLE BOUNDARIES] This validates container-to-hub registration/version behavior. It does not validate your business payload correctness or protocol-specific output semantics.

References

• sdk/worker/repo-management/src/commands/test-container.ts
• sdk/worker/repo-management/src/lib/mock-hub.ts