gcloud alpha container hub config-management describe

gcloud alpha container hub config-management describe - describe the Config Management feature

gcloud alpha container hub config-management describe [--memberships=[MEMBERSHIPS,…] : --location=LOCATION] [--view=VIEW : --filter=EXPRESSION --sort-by=[FIELD,…]] [GCLOUD_WIDE_FLAG …]

gcloud alpha container hub config-management describe

To describe select membership configurations, run:

gcloud alpha container hub config-management describe --memberships=example-membership-1,example-membership-2

To list the membership configurations, run:

gcloud alpha container hub config-management describe --view=list

MEMBERSHIP	LOCATION	STATUS	INSTALL_STATE	STOP_STATE	SYNC_STATE	VERSION	SYNCED_TO_FLEET_DEFAULT
example-membership-1	asia-east1	OK	CONFIG_SYNC_NOT_INSTALLED		NOT_INSTALLED		FLEET_DEFAULT_NOT_CONFIGURED
example-membership-2	us-central1	OK	CONFIG_SYNC_INSTALLED	NOT_STOPPED	SYNCED	1.22.0	FLEET_DEFAULT_NOT_CONFIGURED
example-membership-3	us-central1	ERROR	CONFIG_SYNC_INSTALLED	NOT_STOPPED	ERROR	1.21.3	FLEET_DEFAULT_NOT_CONFIGURED

Memberships to print configurations for. Errors if a specified membership does not have a configuration for this feature.

Membership resource - The group of arguments defining one or more memberships. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

• provide the argument --memberships on the command line with a fully specified name;
• provide the argument --project on the command line;
• set the property core/project.

--memberships=[MEMBERSHIPS,…]

IDs of the memberships or fully qualified identifiers for the memberships.

To set the memberships attribute:

• provide the argument --memberships on the command line.

This flag argument must be specified if any of the other arguments in this group are specified.

--location=LOCATION

Location for the memberships.

To set the location attribute:

• provide the argument --memberships on the command line with a fully specified name;
• provide the argument --location on the command line;
• set the property gkehub/location.

--view=VIEW

View of the feature. VIEW must be one of:

full

Default view. Prints the entire feature.

list

List of membership configurations. Default format is a table summary.

The SYNCED_TO_FLEET_DEFAULT column may display UNKNOWN for any membership whose configuration has not been updated since the fleet-default membership configuration enablement.

To view the underlying configurations instead of the table summary for select memberships, run:

gcloud alpha container hub config-management describe --view=list --format=yaml --memberships=example-membership-1,example-membership-2

List command flags. Only specify when --view=list. Does not include support for --limit.

--filter=EXPRESSION

Apply a Boolean filter EXPRESSION to each resource item to be listed. If the expression evaluates True, then that item is listed. For more details and examples of filter expressions, run $ gcloud topic filters. This flag interacts with other flags that are applied in this order: --flatten, --sort-by, --filter, --limit.

To filter for memberships with an overall status of ERROR, use the COLUMN~VALUE pattern and run:

gcloud alpha container hub config-management describe --view=list --filter=STATUS~ERROR

To filter for memberships that are synced to the fleet-default membership configuration, run:

gcloud alpha container hub config-management describe --view=list --filter="spec.origin.type.synced_to_fleet_default()~YES"

SYNCED_TO_FLEET_DEFAULT is the only column that requires filtering on the underlying configuration field instead of the column name. An alternative is to --sort-by=SYNCED_TO_FLEET_DEFAULT and filter by eye.

To filter on a configuration field not in the table summary, in this case the Config Sync repo, run:

gcloud alpha container hub config-management describe --view=list --format=yaml --filter="spec.configmanagement.configSync.git.syncRepo~https://\
github.com/GoogleCloudPlatform/anthos-config-management-samples.git"

--sort-by=[FIELD,…]

Comma-separated list of resource field key names to sort by. The default order is ascending. Prefix a field with ``~´´ for descending order on that field. This flag interacts with other flags that are applied in this order: --flatten, --sort-by, --filter, --limit.

The default table summary sorts by LOCATION then MEMBERSHIP.

To sort the table by VERSION instead, run:

gcloud alpha container hub config-management describe --view=list --sort-by=VERSION

To sort by a configuration field not in the table summary, in this case the Config Sync repo, and print its values in a table, run:

gcloud alpha container hub config-management describe --view=list --sort-by="spec.configmanagement.configSync.git.syncRepo" --format="table(MEMBERSHIP,LOCATION,spec.configmanagement.configSync.git.syncRepo:label=REPO)"

Run $ gcloud help for details.