- NAME
-
- gcloud alpha container fleet config-management describe - describe the Config Management feature
- SYNOPSIS
-
-
gcloud alpha container fleet config-management describe
[--memberships
=[MEMBERSHIPS
,…] :--location
=LOCATION
] [--view
=VIEW
:--filter
=EXPRESSION
--sort-by
=[FIELD
,…]] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
Describe the Config Management feature. - EXAMPLES
-
To describe the entire Config Management feature, run:
gcloud alpha container fleet config-management describe
To describe select membership configurations, run:
gcloud alpha container fleet config-management describe --memberships=example-membership-1,example-membership-2
To list the membership configurations, run:
gcloud alpha container fleet 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 - FLAGS
-
-
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.
-
provide the argument
--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
.
-
provide the argument
-
provide the argument
-
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.
--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 displayUNKNOWN
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 fleet 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 evaluatesTrue
, 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
pattern and run:COLUMN~VALUE
gcloud alpha container fleet 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 fleet 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 fleet 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
thenMEMBERSHIP
.To sort the table by
VERSION
instead, run:gcloud alpha container fleet 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 fleet config-management describe --view=list --sort-by="spec.configmanagement.configSync.git.syncRepo" --format="table(MEMBERSHIP,LOCATION,spec.configmanagement.configSync.git.syncRepo:label=REPO)"
-
Memberships to print configurations for. Errors if a specified membership does
not have a configuration for this feature.
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file
,--account
,--billing-project
,--configuration
,--flags-file
,--flatten
,--format
,--help
,--impersonate-service-account
,--log-http
,--project
,--quiet
,--trace-token
,--user-output-enabled
,--verbosity
.Run
$ gcloud help
for details. - NOTES
-
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation-only early access
allowlist. These variants are also available:
gcloud container fleet config-management describe
gcloud beta container fleet config-management describe
gcloud alpha container fleet config-management describe
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-30 UTC.