E SrSSKJr SSKJr SSKJr SSKrSSKrSSKrSSKJ r SSK J r SSK J r SS K J r SS K Jr SS KJr SS KJr \R("S SSS\R*R,SSSS9r\R("SSSS\R*R0SSSS9rSrSrSrSrSrSrS r SNS!jr!SNS"jr"S#r#SOS$jr$SOS%jr%S&r&S'r'SPS(jr(S)S*/r)SPS+jr*S,r+S-r,S.r-S/r.S0r/S1r0S2r1S3r2S4r3S5r4S6r5S7r6S8r7S9r8S:r9S;r:S<r;S=rr=SPS?jr>S@r?SAr@SPSB\ SC\ASDS4SEjjrBSFrCSB\R4SGjrESB\R4SHjrFSB\R4SIjrG"SJSK5rHSB\R4SLjrISMrJg)Qz7Flags for the compute instance groups managed commands.)absolute_import)division)unicode_literalsN)Any) arg_parsers)base) exceptions)parser_arguments)flags) arg_utilsz --templatezinstance templateTFzcompute.instanceTemplateszcompute.regionInstanceTemplatesz Specifies the instance template to use when creating new instances. An instance template is either a global or regional resource. ) resource_namerequiredpluralscope_flags_usageglobal_collectionregional_collection short_helpz --multi-migz multi-MIGzcompute.regionMultiMigszr Specifies the name or URL of the multi-MIG that will be attached to selected managed instance group. )r rrrrregion_help_text region_hiddenz table( name, location():label=LOCATION, location_scope():label=SCOPE, baseInstanceName, size, targetSize, instanceTemplate.basename(), autoscaled ) cLURSSSS.S[RSS9 g)Nz--typeDo not proactively replace VMs. Create new VMs and delete old ones on resizes of the group and when you target specific VMs to be updated or recreated.zReplace instances proactively. opportunistic proactiverzDesired update type.)choicesdefaultcategoryhelp) add_argumentrCOMMONLY_USED_FLAGSparsers Glib/googlecloudsdk/command_lib/compute/instance_groups/managed/flags.py AddTypeArgr$Ls8,8 '' ! c.URS[SS9 g)Nz --max-surgea=Maximum additional number of instances that can be created during the update process. This can be a fixed number (e.g. 5) or a percentage of size to the managed instance group (e.g. 10%). Defaults to 0 if the managed instance group has stateful configuration, or to the number of zones in which it operates otherwise.typerrstrr!s r#AddMaxSurgeArgr+]s!  @  r%c.URS[SS9 g)Nz--max-unavailableaMaximum number of instances that can be unavailable during the update process. This can be a fixed number (e.g. 5) or a percentage of size to the managed instance group (e.g. 10%). Defaults to the number of zones in which the managed instance group operates.r'r)r!s r#AddMaxUnavailableArgr-ms   :  r%cJURS[R"SS9SS9 g)Nz --min-ready0s lower_boundzMinimum time for which a newly created instance should be ready to be considered available. For example `10s` for 10 seconds. See $ gcloud topic datetimes for information on duration formats.r'rrDurationr!s r#AddMinReadyArgr4|s+   D 1 !  r%c,URSSSS.SS9 g)Nz--replacement-methodz9Delete old instances and create instances with new names.zjRecreate instances and preserve the instance names. The instance IDs and creation timestamps might change. substituterecreatezType of replacement method. Specifies what action will be taken to update instances. Defaults to ``recreate`` if the managed instance group has stateful configuration, or to ``substitute`` otherwise.rrrr!s r#AddReplacementMethodFlagr;s/JG  Or%c&URSSSS9 g)Nz--force store_truezNIf set, accepts any original or new version configurations without validation.actionrr:r!s r# AddForceArgr@s   / r%c R[R"SSSSRUS94/5$)z;Return possible instance action choices without NONE value.)refreshzApply the new configuration without stopping VMs, if possible. For example, use ``refresh`` to apply changes that only affect metadata or additional disks.)restartzApply the new configuration without replacing VMs, if possible. For example, stopping VMs and starting them again is sufficient to apply changes to machine type.replacezHReplace old VMs according to the --{flag_prefix}replacement-method flag. flag_prefix) collections OrderedDictformatrEs r# InstanceActionChoicesWithoutNonerJs?   8 F{F + #" r%c0[SS0[U55$)z8Return possible instance action choices with NONE value.nonez No action)_CombineOrderedChoicesrJrEs r#InstanceActionChoicesWithNonerNs  {=kJ r%c[R"/5nURUR55 URUR55 U$N)rGrHupdateitems)choices1choices2mergeds r#rMrMs=  " "2 &&-- !-- ! -r%c^U(a [5O [5nURSUUSS9 g)Nz--minimal-actionaUse this flag to minimize disruption as much as possible or to apply a more disruptive action than is strictly necessary. The MIG performs at least this action on each instance while updating. If the update requires a more disruptive action than the one specified here, then the more disruptive action is performed. If you omit this flag, the update uses the ``minimal-action'' value from the MIG's update policy, unless it is not set in which case the default is ``replace''.rrrrNrJrr"choices_with_nonerrs r#AddMinimalActionArgr[s> $% + -   @  r%c^U(a [5O [5nURSUUSS9 g)Nz --most-disruptive-allowed-actiona Use this flag to prevent an update if it requires more disruption than you can afford. At most, the MIG performs the specified action on each instance while updating. If the update requires a more disruptive action than the one specified here, then the update fails and no changes are made. If you omit this flag, the update uses the ``most-disruptive-allowed-action'' value from the MIG's update policy, unless it is not set in which case the default is ``replace''.rWrXrYs r#AddMostDisruptiveActionArgr]s= $% + -  ( '  r%cURSSS9nURS[R"SS9SSSS 9 URS SS S S 9 [ USS5 [ USS5 g)z*Add args for the update-instances command.T)rmutexz --instances min_lengthINSTANCEFzNames of instances to update.)r(metavarrrz--all-instancesr=z"Update all instances in the group.)rr?rrLrDN) add_grouprrArgListr[r])r"instance_selector_groups r#AddUpdateInstancesArgsrhs",,d$,G&&   ! , * '&&  / ' fdF+VT95r%c*SnURSSUS9 g)NaSpecifies whether the request should proceed even if the request includes instances that are not members of the group or that are already being deleted or abandoned. By default, if you omit this flag and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a badly formatted instance name or a reference to an instance that exists in a zone or region other than the group's zone or region.z$--skip-instances-on-validation-errorr=r>r:r" help_texts r#AddGracefulValidationArgrls'() ,  r%cU(agg)Nz table(project(), zone(), instanceName:label=INSTANCE, status, validationError:label=VALIDATION_ERROR)zp table(project(), zone(), instanceName:label=INSTANCE, status))with_validation_errors r#'GetCommonPerInstanceCommandOutputFormatrp s 9 r%NONE PROACTIVEcURSSSS9n[U5 [U5 [U5 [ U5 [ U5 [ U5 U(a [U5 gg)z8Add flags required for setting update policy attributes.FzEParameters for setting update policy for this managed instance group.)rr_rN)re_AddUpdatePolicyTypeFlag"_AddUpdatePolicyMaxUnavailableFlag_AddUpdatePolicyMaxSurgeFlag!_AddUpdatePolicyMinimalActionFlag(_AddUpdatePolicyMostDisruptiveActionFlag%_AddUpdatePolicyReplacementMethodFlag_AddUpdatePolicyMinReadyFlag)r"support_min_ready_flaggroups r#AddMigUpdatePolicyFlagsr}3sd       %5!$U+u%#E**51'. 'r%c:SnSSS.nURSSSUUS9 g ) z,Add --update-policy-type flag to the parser.a3Specifies the type of update process. You can specify either ``proactive`` so that the managed instance group proactively executes actions in order to bring VMs to their target versions or ``opportunistic`` so that no action is proactively executed but the update will be performed as part of other actions.rzReplace VMs proactively.rz--update-policy-type UPDATE_TYPEc"UR5$rPlowerxs r#*_AddUpdatePolicyTypeFlag..\ QWWYr%rdr(rrNr:)r|rkrs r#rtrtGsA  ".  '   r%c0URSS[SS9 g)Nz--update-policy-max-unavailableMAX_UNAVAILABLEzMaximum number of VMs that can be unavailable during the update process. This can be a fixed number (e.g. 5) or a percentage of size to the managed instance group (e.g. 10%). Defaults to the number of zones in which the managed instance group operates.rdr(rr)r|s r#rurubs$'  J  r%c0URSS[SS9 g)Nz--update-policy-max-surge MAX_SURGEzMaximum additional number of VMs that can be created during the update process. This can be a fixed number (e.g. 5) or a percentage of size to the managed instance group (e.g. 10%).rr)rs r#rvrvps#!  >  r%cLURSS[R"SS9SS9 g)Nz--update-policy-min-ready MIN_READYr/r0zMinimum time for which a newly created VM should be ready to be considered available. For example `10s` for 10 seconds. See $ gcloud topic datetimes for information on duration formats.rr2rs r#rzrz}s/!   D 1 J  r%c4URS[SS9SS9 g)Nz--update-policy-minimal-actionupdate-policy-rEa6Use this flag to minimize disruption as much as possible or to apply a more disruptive action than is strictly necessary. The MIG performs at least this action on each VM while updating. If the update requires a more disruptive action than the one specified here, then the more disruptive action is performed. r9rrNrs r#rwrws&&+8HI   r%c4URS[SS9SS9 g)Nz&--update-policy-most-disruptive-actionrrEaUse this flag to prevent an update if it requires more disruption than you can afford. At most, the MIG performs the specified action on each VM while updating. If the update requires a more disruptive action than the one specified here, then the update fails and no changes are made.r9rrs r#rxrxs&.+8HI 6  r%c,URSSSS.SS9 g)Nz"--update-policy-replacement-methodz-Delete old VMs and create VMs with new names.zXRecreate VMs and preserve the VM names. The VM IDs and creation timestamps might change.r6zNType of replacement method. Specifies what action will be taken to update VMs.r9r:rs r#ryrys+*GA  r%c:SnSSS.nURSSSUUS9 g ) z6Add --instance-redistribution-type flag to the parser.a Specifies the type of the instance redistribution policy. An instance redistribution type lets you enable or disable automatic instance redistribution across zones to meet the group's target distribution shape. An instance redistribution type can be specified only for a non-autoscaled regional managed instance group. By default it is set to ``proactive''. zHThe managed instance group does not redistribute instances across zones.z_The managed instance group proactively redistributes instances to meet its target distribution.)rLrz--instance-redistribution-typeTYPEc"UR5$rPrrs r#r6AddMigInstanceRedistributionTypeFlag..rr%rNr:r"rkrs r#$AddMigInstanceRedistributionTypeFlagrs> )  * ' &   r%cXSnSSSSS.nURSS[RUUS 9 g ) z3Add --target-distribution-shape flag to the parser.z Specifies how a regional managed instance group distributes its instances across zones within the region. The default shape is ``even''. a4The group schedules VM instance creation and deletion to achieve and maintain an even number of managed instances across the selected zones. The distribution is even when the number of managed instances does not differ by more than 1 between any two zones. Recommended for highly available serving workloads.a.The group prioritizes acquisition of resources, scheduling VMs in zones where resources are available while distributing VMs as evenly as possible across selected zones to minimize the impact of zonal failure. Recommended for highly available serving or batch workloads that do not require autoscaling.zThe group picks zones for creating VM instances to fulfill the requested number of VMs within present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads that do not require high availability.a_The group schedules all instances within a single zone. The zone is chosen based on hardware support, current resources availability, and matching reservations. The group might not be able to create the requested number of VMs in case of zonal resource availability constraints. Recommended for workloads requiring extensive communication between VMs.)evenbalancedanyzany-single-zonez--target-distribution-shapeSHAPErNrr EnumNameToChoicers r#'AddMigDistributionPolicyTargetShapeFlagrsP)  @ 7 C  ;- '> #  % %  r%c SnSnURU[R"SS90[RSUS9 SnSnURU[R"SS90[RSUS9 g ) z3Adds args for all-instances' config update command. --metadataz8Add metadata to the group's all instances configuration.r`ra KEY=VALUE)r(rr?rdr--labelsz6Add labels to the group's all instances configuration.N)rrArgDictStoreOnceAction)r"metadata_argument_namemetadata_help_textlabels_argument_names r##AddFlagsForUpdateAllInstancesConfigrs(@    ! ,  ( (  $O   ! ,  ( (  r%cSnURUS[R"SS9SS9 SnURUS[R"SS9SS9 g ) z3Adds args for all-instances' config delete command.rKEYr`razBRemove metadata keys from the group's all instances configuration.rrz@Remove labels keys from the group's all instances configuration.N)rrrf)r"rrs r##AddFlagsForDeleteAllInstancesConfigr sf(   ! , O $   ! , M r%cUR5S:XagUHCnURU5(dMURU5nSU-n[R"XES9e g)aaFor zonal MIGs validate that user did not supply any RMIG-specific flags. Can be safely called from GA track for all flags, unknowns are ignored. Args: args: provided arguments. regional_flags_dests: list of RMIG-specific flag dests (names of the attributes used to store flag values in args). igm_ref: resource reference of the target IGM. z#compute.regionInstanceGroupManagersNzCFlag %s may be specified for regional managed instance groups only.)parameter_namemessage) CollectionIsKnownAndSpecifiedGetFlagr InvalidArgumentException)argsregional_flags_destsigm_refdest flag_name error_messages r#ValidateRegionalMigFlagsUsager4sg BB "d %%,,t$i O m  / /"  #r%c:SnSSS.nURSSSUUS9 g ) z8Add --list-managed-instances-results flag to the parser.z Pagination behavior for the group's listManagedInstances API method. This flag does not affect the group's gcloud or console list-instances behavior. By default it is set to ``pageless''. zPagination is disabled for the group's listManagedInstances API method. maxResults and pageToken query parameters are ignored and all instances are returned in a single response.zPagination is enabled for the group's listManagedInstances API method. maxResults and pageToken query parameters are respected.)pageless paginatedz --list-managed-instances-resultsMODEc"UR5$rPrrs r#r7AddMigListManagedInstancesResultsFlag..brr%rNr:rs r#%AddMigListManagedInstancesResultsFlagrLs?) =  M ' (   r%cFSnURS[RUS9 g)z1Adding force update on repair flag to the parser.a Specifies whether to apply the group's latest configuration when repairing a VM. If you updated the group's instance template or per-instance configurations after the VM was created, then these changes are applied when VM is repaired. If this flag is disabled with ``-no-force-update-on-repair'', then updates are applied in accordance with the group's update policy type. By default, this flag is disabled. z--force-update-on-repairr>N)rrStoreTrueFalseActionrjs r#AddMigForceUpdateOnRepairFlagsrhs-)   - - r%cU[RR:Xa [U5 gU[RR:Xa [ U5 g[ U5 grP)r ReleaseTrackALPHA#AddMigDefaultActionOnVmFailureAlphaBETA"AddMigDefaultActionOnVmFailureBeta AddMigDefaultActionOnVmFailureGA)r" release_tracks r#AddMigDefaultActionOnVmFailurerysBd''---'/))...&v.$V,r%cTSnSSS.nURSS[RUUS9 g) /Add default action on VM failure to the parser.z Specifies the action that a MIG performs on a failed or an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. By default, the value of the flag is set to ``repair''.z6MIG automatically repairs a failed or an unhealthy VM.z0MIG does not repair a failed or an unhealthy VM.)repair do-nothing--default-action-on-vm-failureACTION_ON_VM_FAILURErNrrs r#rrsDA) IF '  &$  % %  r%czSn[R"SS/5nURSS[RUUS9 g)r( Specifies the action that a MIG performs on a failed VM. If the value of the onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also applies to the VMs on which your application fails a health check. By default, the value of the flag is set to ``repair''.rzA(Default) MIG automatically repairs a failed VM by recreating it.rz MIG does not repair a failed VM.rrrNrGrHrr rrs r#rrsUA)  # #9 % ' &$  % %  r%czSn[R"/SQ5nURSS[RUUS9 g)rr)rr)deletezNMIG deletes a failed VM. Deleting the VM decreases the target size of the MIG.rrrNrrs r#rrsKA)  # #% ' &$  % %  r%czSn[R"/SQ5nURSS[RUUS9 g)z3Add action on VM failed health check to the parser.z Specifies the action that a MIG performs on an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. By default, the value of the flag is set to ``default-action''.))zdefault-actionzS(Default) MIG uses the same action configured for the defaultActionOnFailure field.)rz$MIG does not repair an unhealthy VM.)rz;MIG automatically repairs an unhealthy VM by recreating it.z"--action-on-vm-failed-health-checkACTION_ON_FAILED_HEALTH_CHECKrNrrs r#!AddMigActionOnVmFailedHealthCheckrsKY)  # # % ' *-  % %  r%c lURSU[R"S[RSS9SS9 g)zAdd --size flag to the parser.z--sizerT) unlimitedz=Target number of running instances in managed instance group.)rr(rN)rr BoundedIntsysmaxsize)r"rs r#AddMigSizeFlagrs4  ! !!S[[D A J r%cSSS.nURS[USS9 URS[SS 9 URS [S S 9 URS [S S 9 g)z.Add flags required for setting standby policy.z]MIG does not automatically resume or start VMs in the standby pool when the group scales out.zMIG automatically resumes or starts VMs in the standby pool when the group scales out, and replenishes the standby pool afterwards.)manualzscale-out-poolz--standby-policy-modez Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is ``manual''. )r(rrz--standby-policy-initial-delayzSpecifies the number of seconds that the MIG should wait before suspending or stopping a VM. The initial delay gives the initialization script the time to prepare your VM for a quick scale out.r'z--suspended-sizez8Specifies the target size of suspended VMs in the group.z--stopped-sizez6Specifies the target size of stopped VMs in the group.N)rr*int)r"standby_policy_mode_choicess r#AddStandbyPolicyFlagsrs ( L !  )  &       E    Cr%clURS[R"5S[RSS9 g)z(Adds resource manager tag related flags.z--resource-manager-tagsrzSpecifies a list of resource manager tags to apply to the managed instance group. A resource manager tag is a key-value pair. You can attach exactly one value to a MIG for a given key. A MIG can have a maximum of 50 key-value pairs attached.)r(rdr?rN)rrr UpdateActionr!s r#AddMigResourceManagerTagsFlagsrs5      % % <  r%r" is_updatereturnc&URS[R"5SSS9 URSSS[5[R"5S9 U(a7URS S S S 9 URS [R"5SSS9 gg)z&Adds instance flexibility policy args.z"--instance-selection-machine-types MACHINE_TYPEzMachine types that are used to create VMs in the managed instance group. If not provided, the machine type specified in the instance template is used.r(rdrz--instance-selectionzNamed selection of machine types with an optional rank. For example, `--instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0"`zNname=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK])rrdr(r?z --remove-instance-selections-allr=zDRemove all instance selections from the instance flexibility policy.r>z--remove-instance-selectionsINSTANCE_SELECTION_NAMEzIRemove specific instance selections from the instance flexibility policy.N)rrrfArgMultiValueDict FlattenAction)r"rs r# AddInstanceFlexibilityPolicyArgsr)s  *         ~_    & & (  *   &  ")  r%cTSnSSS.nURSS[RUUS9 g) z*Add target size policy mode to the parser.z=Specifies the mode in which the MIG creates VMs in the group.z(Default) MIG creates VMs individually. If the MIG cannot create any VM to meet the specified ``size``, then the MIG creates the VMs for which resources are available. The MIG then attempts to create the remaining VMs until the resources become available.zMIG creates VMs all at once. If the MIG cannot create any VM to meet the specified ``size``, then the MIG waits until the resources become available to create all VMs.) individualbulkz--target-size-policy-modeTARGET_SIZE_POLICY_MODErNrrs r#AddTargetSizePolicyModeFlagrWsCM) A  1 ' !'  % %  r%c0URS[SSS9 g)zAdd workload policy flag.z--workload-policyWORKLOAD_POLICYzSpecifies the workload policy for the managed instance group. It can be a full or partial URL to a resource policy containing the workload policy.rNr)r!s r#AddWorkloadPolicyFlagrqs#  !  r%c&URSSSS9 g)z Add remove workload policy flag.z--remove-workload-policyr=z=Detaches the workload policy from the managed instance group.r>Nr:r!s r#AddRemoveWorkloadPolicyFlagrs  I r%cNURSS9n[U5 [U5 g)z'Add flags for managing workload policy.T)r_N)rerr)r"workload_policy_groups r#AddWorkloadPolicyFlagsrs( ***6-.34r%c$\rSrSrSrSrSrSrg)rizConverts argument values into multi-valued mappings. Values for repeated keys are collected in a list. Ensures all values are key-value pairs and handles invalid cases. czSnSRUS9n[R"U[R5Ulg)N=z([^\s{ops}]+)\s*{ops}\s*(.*))ops)rIrecompileDOTALL _key_op_value)selfr key_op_value_patterns r#__init__ArgMultiValueDict.__init__s3 C:AAcAJ$8"))DDr%cURS5Vs/sHo"R5PM nn[R"5nUGH2nSU;a%[R "SR U55eURRU5nU(d%[R "SR U55eURS5R5URS5R5pU(aU(d%[R "SR U55eSU;a%[R "SR U55eURU/5RU5 GM5 U$s snf)N,rzInvalid flag value [{0}]r`) splitstriprGrHrArgumentTypeErrorrIr matchr| setdefaultappend) r arg_valueitemarg_listarg_dictargrkeyvalues r#__call__ArgMultiValueDict.__call__sE)2)=>)= )=H>&&(H C++ & - -c 2    &&s+e ++ & - -c 2  ;;q>'')5;;q>+?+?+A5 ++ & - -c 2   ++ & - -c 2  #r"))%0+. O3?sE?)r N)__name__ __module__ __qualname____firstlineno____doc__rr"__static_attributes__rnr%r#rrs E r%rcPSSS.nURSS[RUSS9 g) z"Add on repair flags to the parser.z8(Default) MIG cannot change a VM's zone during a repair.z;MIG can select a different zone for the VM during a repair.)noyesz--on-repair-allow-changing-zoneON_REPAIR_ALLOW_CHANGING_ZONEzASpecifies whether the MIG can change a VM's zone during a repair.rNr)r"allow_changing_zone_choicess r#AddOnRepairFlagsr/s= G J! '-  % %) N r%cpURSS9nURSSSSS9 [RU5 g)z#Adds Multi-MIG flags to the parser.T)hiddenz--clear-multi-migr=NzR Removes this managed instance group from the Multi-MIG it belongs to. )r?rr)add_mutually_exclusive_groupr MULTI_MIG_ARG AddArgument)r"multi_mig_groups r#AddMultiMigFlagsr6sF77t7D/  O,r%))TN)F)Kr( __future__rrrrGr rtypingrgooglecloudsdk.callioperrr r "googlecloudsdk.command_lib.computer compute_flags$googlecloudsdk.command_lib.util.apisr ResourceArgumentScopeFlagsUsageDONT_USE_SCOPE_FLAGSINSTANCE_TEMPLATE_ARGUSE_EXISTING_SCOPE_FLAGSr3DEFAULT_CREATE_OR_LIST_FORMATr$r+r-r4r;r@rJrNrMr[r]rhrlrpINSTANCE_REDISTRIBUTION_TYPESr}rtrurvrzrwrxryrrrrrrrrrrrrrrrboolrrArgumentInterceptorrrrrr/r6rnr%r#rGs>&' /(.4E:&66%  #33HH19 ..  #33LL1   !"   (:**6(   "( 5((6     "<+\8(08"-*046(V $+ ++ +\4 "2"F"F (8(L(L5#3#G#G5&&R -AA  -r%