feat: add konnect-control-plane-id flag

[asartori86]

Introduce the --konnect-control-plane-id flag, which is mutually exclusive with the --konnect-control-plane-name flag. While names are more user-friendly, IDs are better suited for automation scripts due to their simplicity (no spaces, special characters, or sensitive names). This flag is intended for internal use and is therefore hidden.

requires Kong/go-database-reconciler#303

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 0% with 52 lines in your changes missing coverage. Please review.

Project coverage is 28.03%. Comparing base (e835014) to head (becd8f1).

Files with missing lines	Patch %	Lines
cmd/common_konnect.go	0.00%	26 Missing ⚠️
cmd/common.go	0.00%	18 Missing ⚠️
cmd/root.go	0.00%	8 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1686      +/-   ##
==========================================
- Coverage   28.19%   28.03%   -0.16%     
==========================================
  Files          67       67              
  Lines        6949     6988      +39     
==========================================
  Hits         1959     1959              
- Misses       4848     4887      +39     
  Partials      142      142              

☔ View full report in Codecov by Sentry.
📢 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.

[GGabriele]

@Prashansa-K can you please take a look?

[harshadixit12]

gateway_validate command seems to fail when id is given

Error: [konnect] section not specified - ensure details are set via cli flags

Also, some tests wherever relevant would be great!

[asartori86]

gateway_validate command seems to fail when id is given

Error: [konnect] section not specified - ensure details are set via cli flags

Also, some tests wherever relevant would be great!

could you share the full command line used?

this works for me

$ ./deck gateway validate --konnect-addr https://us.api.konghq.tech --konnect-token $KONNECT_TOKEN_DEV  test.json 

$ cat test.json
{ "_format_version": "3.0"
, "_konnect": {"control_plane_id": "c4fe2fd4-c3e1-494e-b1ea-40a73415c456"}
}