08SrSSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SSKJ r SS K J r SS K Jr SS K Jr SS K Jr SS KJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SSK!J"r# \RH"\RJRL\RJRN5"SS\RP55r)\RT\RH"\RJRV5"SS\RP555r,g)z2Implements command to update an ops agents policy.)absolute_import)division)unicode_literals)encoding)cloud_ops_agents_policy)cloud_ops_agents_util)ops_agents_policy)9cloud_ops_agents_policy_to_os_assignment_policy_converter)+guest_policy_to_ops_agents_policy_converter)+ops_agents_policy_to_guest_policy_converter)9os_policy_assignment_to_cloud_ops_agents_policy_converter)!cloud_ops_agents_policy_validator)ops_agents_policy_validator)utils)base) parser_utils) properties)yaml)osconfig_v1_messagesc8\rSrSrSrSSS.r\S5rSrSr g ) UpdateAlphaBeta(aUpdate a Google Cloud operations suite agent (Ops Agent) policy. *{command}* updates a policy that facilitates agent management across Compute Engine instances based on user specified instance filters. This policy installs, specifies versioning, enables autoupgrade, and removes Ops Agents. The command returns the content of the updated policy or an error indicating why the update fails. The updated policy takes effect asynchronously. It can take 10-15 minutes for the VMs to enforce the updated policy. The available flags for the ``update'' command are similar to the flags for the ``create'' command. All the flags for ``update'' are optional. If a flag is not specified, it retains the original value. The full value of each flag needs to be re-stated during ``update''. Take the ``--agents'' flag for example: If the original policy specified two agents (``--agents="type=logging;type=metrics"''), and only one agent (``--agents="type=logging"'') is specified in a *{command}* command, then the policy stops managing and enforcing the unspecified agent. In order to remove the metrics agent in this case, set the package state explicitly to ``removed'' (``--agents="type=logging;type=metrics,package-state=removed"''). In order to explicitly clear the ``--group-labels'', ``--instances'', and ``--zones'' instance filters, use the following flags as documented below: ``--clear-group-labels'', ``--clear-instances'', and ``--clear-zones'' flags. {description}a To update a policy named ``ops-agents-test-policy'' to target a single CentOS 7 VM instance named ``zones/us-central1-a/instances/test-instance'' for testing or development, and install both Logging and Monitoring Agents on that VM instance, run: $ {command} ops-agents-test-policy --agent-rules="type=logging,enable-autoupgrade=false;type=metrics,enable-autoupgrade=false" --instances=zones/us-central1-a/instances/test-instance --os-types=short-name=centos,version=7 To update a policy named ``ops-agents-prod-policy'' to target all CentOS 7 VMs in zone ``us-central1-a'' with either ``env=prod,product=myapp'' labels or ``env=staging,product=myapp'' labels, and make sure the logging agent and metrics agent versions are pinned to specific major versions for staging and production, run: $ {command} ops-agents-prod-policy --agent-rules="type=logging,version=1.*.*,enable-autoupgrade=false;type=metrics,version=6.*.*,enable-autoupgrade=false" --group-labels="env=prod,product=myapp;env=staging,product=myapp" --os-types=short-name=centos,version=7 --zones=us-central1-a To update a policy named ``ops-agents-labels-policy'' to clear the instances filters and use a group labels filter instead to target VMs with either ``env=prod,product=myapp'' or ``env=staging,product=myapp'' labels, run: $ {command} ops-agents-labels-policy --clear-instances --group-labels="env=prod,product=myapp;env=staging,product=myapp" To perform the same update as above, conditionally on the fact that the policy's etag (retrieved by an earlier command) is ``f59741c8-bb5e-4ee6-bf6f-c4ebeb6b06e0'', run: $ {command} ops-agents-labels-policy --clear-instances --group-labels="env=prod,product=myapp;env=staging,product=myapp" --etag=f59741c8-bb5e-4ee6-bf6f-c4ebeb6b06e0  DESCRIPTIONEXAMPLESc[R"U5 [R"USS9 [R"U5 g)See base class.F)parserrequiredN)r AddSharedArgsAddMutationArgs AddUpdateArgsrs ;lib/surface/compute/instances/ops_agents/policies/update.pyArgsUpdateAlphaBeta.Argshs0v&  ?v&c UR5n[R"USS9n[R"USS9n[R R RR5nUR[R"SXQR5S9nURnURU5n[R "U5n ["R$"U UR&UR(UR*UR,UR.(a/O UR0UR2(a/O UR4UR6(a/O UR85n [:R<"U 5 [>R@"XJURB5n UREU [R"SXQR5SS9nURGU5n [R "U 5n U $)rv1beta)api_version_overrideprojects)nameN) guestPolicyr- updateMask)$ ReleaseTrackosconfig_api_utilsGetClientInstanceGetClientMessagesrVALUEScoreproject GetOrFail'OsconfigProjectsGuestPoliciesGetRequestosconfig_command_utilsGetGuestPolicyUriPath POLICY_IDprojects_guestPoliciesGetr "ConvertGuestPolicyToOpsAgentPolicyr UpdateOpsAgentsPolicy descriptionetag agent_rulesos_typesclear_group_labels group_labels clear_zoneszonesclear_instances instancesrValidateOpsAgentsPolicyr "ConvertOpsAgentPolicyToGuestPolicyrecipes)OsconfigProjectsGuestPoliciesPatchRequestPatch)selfargs release_trackclientmessagesr6requestservicecurrent_guest_policycurrent_ops_agents_policyupdated_ops_agents_policyupdated_os_config_policycomplete_os_config_policycomplete_ops_agent_policys r%RunUpdateAlphaBeta.Runos%%'M  1 1HF"33HH$$,,668G>> # 9 9  ?G ++G";;w/ K n n!!2 G G!    %%4+<+<DJJ"" ! 77! Kmm-A-I-I @@, # 9 9   AG!( g 6 K n n!! %$r(N __name__ __module__ __qualname____firstlineno____doc__ detailed_help staticmethodr&r\__static_attributes__r^r(r%rr(s2:% -D'' 0%r(rc8\rSrSrSrSSS.r\S5rSrSr g ) UpdateaUpdate a Google Cloud Observability agents policy for the Ops Agent. *{command}* modifies a policy that facilitates agent management across Compute Engine instances based on user specified instance filters. This policy installs, specifies versioning, and removes Ops Agents. The command returns the content of the modified policy or an error indicating why the modification fails. The modified policy takes effect asynchronously. It can take 10-15 minutes for the VMs to enforce the newly modified policy. rz To update a Google Cloud Observability agents policy, run: $ {command} agent-policy --project=PROJECT --zone=ZONE --file=config.yaml rcURS[SS9 URSSSS9 URSSS S9 URS S SS S 9 g)rr;z ID of the policy. This ID must contain only lowercase letters, numbers, and hyphens, end with a number or a letter, be between 1-63 characters, and be unique within the project. )typehelpz--fileTz YAML file with a subset of agents policy fields you wish to update. For information about the agents policy format, see https://cloud.google.com/stackdriver/docs/solutions/agents/ops-agent/agent-policies#config-files.)r rmz--zonez2 Zone where the agents policy is located.z--debug-dry-run store_truezpIf provided, the resulting OSPolicyAssignment will be printed to standard output and no actual changes are made.)actionhiddenrmN) add_argumentstrr$s r%r& Update.Argss    _ 6   ? r(cUR5n[RRRR 5n[ R"X!RX1R5n[R"UR5n[R"UUS9n[R "U5 ["R$"X1R5n["R&"XqR5n[(R*"U5n [,R."XS9n UR0(aU $U R3U US9n [(R4"U5n U R6n U R9U 5n[:R<"[>R@[:RB"URD55n[FRH"U5nURK5$)r)update_ops_agents_policyr )r-r )oSPolicyAssignmentr-)&r0rr4r5r6r7rGetOpsAgentsPolicyFromApir;zoner load_pathfilerr?rrJr9GetProjectLocationUriPath!GetOsPolicyAssignmentRelativePathr1r3to_os_policy_assignment*ConvertOpsAgentsPolicyToOSPolicyAssignment debug_dry_run8OsconfigProjectsLocationsOsPolicyAssignmentsPatchRequestr2&projects_locations_osPolicyAssignmentsrNrPyValueToMessageosconfigOSPolicyAssignmentMessageToPyValueresponseto_ops_agents_policy/ConvertOsPolicyAssignmentToCloudOpsAgentsPolicy ToPyValue)rOrPrQr6rWconfigupdated_policy parent_path assignment_idrSos_policy_assignmentupdate_requestrRrUupdate_responseupdated_os_policy_assignmentrXs r%r\ Update.Runs%%'M$$,,668G 5 O O~~w ! ^^DII &F,BB!'3N&==nM(BBK+LL^^M"33MBH JJ    !! II3 J   1 1- @F;;GmmN3O$,#<#<##!!/":":;$ LL (  % . . 00r(r^Nr_r^r(r%riris2 % -""H;1r(riN)-rd __future__rrrapitools.base.pyr3googlecloudsdk.api_lib.compute.instances.ops_agentsrrr >googlecloudsdk.api_lib.compute.instances.ops_agents.convertersr r}r r r r>googlecloudsdk.api_lib.compute.instances.ops_agents.validatorsrr(googlecloudsdk.api_lib.compute.os_configrr1googlecloudsdk.callioper@googlecloudsdk.command_lib.compute.instances.ops_agents.policiesr,googlecloudsdk.command_lib.compute.os_configr9googlecloudsdk.corerr1googlecloudsdk.generated_clients.apis.osconfig.v1rr ReleaseTracksr0BETAALPHACommandrUniverseCompatibleGArir^r(r%rs9&'%WUQ`vv]lfP(YX*$^D%%**D,=,=,C,CDv%dllv%Ev%rD%%(()u1T\\u1*u1r(