Skip to content

docs: align website docs with actual CLI flags from e2e tests#139

Merged
aru-amedeo merged 1 commit into
mainfrom
docs/fix-e2e-aligned-flags
Jun 4, 2026
Merged

docs: align website docs with actual CLI flags from e2e tests#139
aru-amedeo merged 1 commit into
mainfrom
docs/fix-e2e-aligned-flags

Conversation

@aru-amedeo
Copy link
Copy Markdown
Member

All flag discrepancies found by comparing e2e test scripts against the Go cmd source and the published website docs.

cloudserver create

  • Replace URI flags (--boot-disk-uri, --vpc-uri, --subnet-uri, --security-group-uri, --keypair-uri) with ID flags that the CLI actually accepts (--boot-disk-id, --vpc-id, --subnet-id, --security-group-id, --keypair-id)
  • Add missing required --zone flag
  • Fix flavor examples (CSO4A8, not small/medium/large)
  • Remove non-existent --elasticip-uri flag

keypair create

  • Add missing required --region flag

keypair update

  • Document as unsupported (API returns error); describe delete+recreate workaround for key rotation

kaas create

  • Replace --vpc-uri / --subnet-uri with --vpc-id / --subnet-id
  • Update example k8s version (1.33.2), instance (K2A4), zone (ITBG-1)
  • Add known-limitation note: node pool fields not round-tripped by SDK, so only --name/--tags updates work reliably

containerregistry create

  • Replace all five URI flags with ID flags (--public-ip-id, --vpc-id, --subnet-id, --security-group-id, --block-storage-id)
  • Add note about required SG rules (TCP/443 ingress + egress)

dbaas create

  • Add required --zone and --storage-size flags
  • Add optional --vpc-id, --subnet-id, --security-group-id, --elastic-ip-id flags
  • Fix --engine-id example (mysql-8.0, not a hex ID)
  • Note that database/user update (PUT) returns HTTP 405

schedule job create

  • Add step flags required by the API: --step-resource-uri, --step-action-uri, --step-http-verb, --step-name
  • Note typology restriction (cloud servers supported; other resource types may not be registered with the scheduler)

All changes mirrored to Italian (i18n/it) translations.

Summary

Related issues

Type of change

  • Bug fix
  • New feature / command
  • Refactor / cleanup
  • Documentation
  • CI / release pipeline
  • Other

Changes

Test plan

  • Unit tests added / updated (go test ./cmd/...)
  • Coverage remains above threshold (go tool cover -func=coverage.txt)
  • Manually tested against a real Aruba Cloud account (or marked N/A)
  • E2E tests passed (or marked N/A)

Checklist

  • go fmt / gofmt -s applied
  • go vet ./... clean
  • No secrets or credentials in the diff
  • Relevant documentation updated (if applicable)

All flag discrepancies found by comparing e2e test scripts against
the Go cmd source and the published website docs.

cloudserver create
- Replace URI flags (--boot-disk-uri, --vpc-uri, --subnet-uri,
  --security-group-uri, --keypair-uri) with ID flags that the CLI
  actually accepts (--boot-disk-id, --vpc-id, --subnet-id,
  --security-group-id, --keypair-id)
- Add missing required --zone flag
- Fix flavor examples (CSO4A8, not small/medium/large)
- Remove non-existent --elasticip-uri flag

keypair create
- Add missing required --region flag

keypair update
- Document as unsupported (API returns error); describe delete+recreate
  workaround for key rotation

kaas create
- Replace --vpc-uri / --subnet-uri with --vpc-id / --subnet-id
- Update example k8s version (1.33.2), instance (K2A4), zone (ITBG-1)
- Add known-limitation note: node pool fields not round-tripped by SDK,
  so only --name/--tags updates work reliably

containerregistry create
- Replace all five URI flags with ID flags (--public-ip-id, --vpc-id,
  --subnet-id, --security-group-id, --block-storage-id)
- Add note about required SG rules (TCP/443 ingress + egress)

dbaas create
- Add required --zone and --storage-size flags
- Add optional --vpc-id, --subnet-id, --security-group-id,
  --elastic-ip-id flags
- Fix --engine-id example (mysql-8.0, not a hex ID)
- Note that database/user update (PUT) returns HTTP 405

schedule job create
- Add step flags required by the API: --step-resource-uri,
  --step-action-uri, --step-http-verb, --step-name
- Note typology restriction (cloud servers supported; other resource
  types may not be registered with the scheduler)

All changes mirrored to Italian (i18n/it) translations.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@codecov
Copy link
Copy Markdown

codecov Bot commented Jun 4, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 79.80%. Comparing base (0b0bd3c) to head (b247f4a).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #139   +/-   ##
=======================================
  Coverage   79.80%   79.80%           
=======================================
  Files          38       38           
  Lines        7467     7467           
=======================================
  Hits         5959     5959           
  Misses        935      935           
  Partials      573      573           
Flag Coverage Δ
unittests 79.80% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@aru-amedeo aru-amedeo marked this pull request as ready for review June 4, 2026 09:22
@aru-amedeo aru-amedeo merged commit ba0fb05 into main Jun 4, 2026
12 checks passed
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