,`SrSSKrSSKrSSKJr SSKJr SSKJr SSKJ r 0r \"S\ \ \ \ \ \ \ \ \ \ \ \ S. S S 9r S rS rS r\R"R$4S\ S\R"4SjjrSr"SS\R*5r\"SS\55r\"SS\55r\"SS\55r\"SS\55r\"SS\55r\"SS\55rS rS!rg)"z#Utilities for working with volumes.N) TypedDict) arg_parsers)base) exceptions VolumeDict) nametypez read-onlybucketlocation size-limitdynamic-mounting mount-optionssecretversionpath instancesF)totalcZSSKJn U$![a [R"5ef=f)aAImports types from the v2 gapic client, handling potential gRPC import errors. Not all gCloud distributions have the gRPC library. Since only workerpools use the gapic client (which requires gRPC), we import it here so only workerpool commands are affected if gRPC is not installed. Returns: The run_v2 types module. rtypes)5googlecloudsdk.generated_clients.gapic_clients.run_v2r ImportErrorserverless_exceptionsNoGrpcInstalledErrorrs -lib/googlecloudsdk/command_lib/run/volumes.pyimport_gapic_client_typesr/s-7K L 7  4 4 667s *c4U[UR5'U$)zdecorator for registering VolumeTypes. Only VolumeTypes with this decorator will be supported in add_volume Args: cls: the decorated class Returns: cls )_supported_volume_typesrclss r_registered_volume_typer!Bs),#((*% *c[X5 URUSS9n[USnURX5 UR X5 UR XU5 XAUS'g)zBAdd the volume described by the given volume dict to the resource.r)rr N)_validate_volume_name_and_typeVolumervalidate_volume_addvalidate_fields fill_volume)volumevolumesmessages release_tracknew_volvol_types r add_volumer/Qsd 7 OOO 0' $VF^ 4( v5 61 v1#&.r"r)r,c[5n[X5 [USnURX5 UR X5 UR X5$)zECreate the volume described by the given volume dict to the resource.r )rr$rr&r'create_volume_v2)r)r,rr.s rr1r1]sO $ %% 7 $VF^ 4( v5 61  " "6 11r"c/n[[R5SS9H:up#XR5;dMUR UR U55 M< SR U5$)z8Generates the help text for all registered volume types.c US$)Nr)ts rvolume_help..osQqTr")keyz )sortedritemsrelease_tracksappend generate_helpjoin)r,hlp_ volume_types r volume_helprBks_ ###%>na2244 jj**=9:  S r"c\rSrSrSr\\RS55r\\RS55r \S5r \\RS55r \\RS55r \\RS55r \\RS 55r\\RS 55r\\R"R$4S j5r\S 5rS rg) _VolumeTypewzBase class for supported volume types. To add a new supported volume type, create a subclass of this type, implement all the abstract methods, and annotate the class with @_registered_volume_type. cg)zThe name of this Volume type. This is the string that will need to be provided as the `type` value in the add volumes flag to use this type of volume. Nr4rs rr_VolumeType.names r"cg)zHelp text for this volume type.Nr4rs rhelp_VolumeType.help r"c>[RR5$)zThe list of release tracks that this volume type should be present in. Used to progressively roll out types of volumes. Returns: A list of base.ReleaseTrack r ReleaseTrack AllValuesrs rr;_VolumeType.release_trackss    & & ((r"c0$)zDA dict of field_name: help text for all fields that must be present.r4r r,s rrequired_fields_VolumeType.required_fields  Ir"c0$)zAA dict of field_name: help text for all fields that are optional.r4rRs roptional_fields_VolumeType.optional_fieldsrUr"cg)z?Fills in the Volume message (V1) from the provided volume dict.Nr4)r r)r-r+s rr(_VolumeType.fill_volumerKr"cg)z6Creates the volume (V2) from the provided volume dict.Nr4)r r)s rr1_VolumeType.create_volume_v2rKr"cg)z7Validate any additional constraints on the volume type.Nr4)r r)r,s rr'_VolumeType.validate_fieldsrKr"cl[URU5R55n[URU5R55nUHnUS:XaM US:XaNXUR 5:wa6[ R "SRUR 5X55eM_XS;dMfXT;dMm[ R "SRUSUSU55e X1R5- nU(a-[ R "SRUSUSU55eg)zFValidate that the volume dict has all needed parameters for this type.rr z%expected volume of type {} but got {}z0Volume {} of type {} had unexpected parameter {}z:Volume {} of type {} requires the following parameters: {}N)setrSkeysrWrrConfigurationErrorformat)r r)r, required_keys optional_keysr8missings rr&_VolumeType.validate_volume_adds#++M:??ABM++M:??ABM  &= ;#((* $%885<<((*fk   %  #(@#66 > E Evv    kkm+G ! 4 4 F M MVnfVng  r"cSRSURU5R555nUR5(aSUS3OSnSRSUR U5R555nUR5(aSUS3OSnSR UR 5UR5UUS9$)z(Generate help text for this volume type. c3H# UHupSRX5v M g7f)z* {}: (required) {} Nrc.0rr?s r ,_VolumeType.generate_help..s' CID &&t11Cs "z c3X# UH upUS:wdM SRX5v M" g7f)rz* {}: (optional) {} Nrkrls rrnros1 CID 6> 2&&t11Cs **z:*{name}*: {hlp} Additional keys: {required}{optional} )rr?requiredoptional)r>rSr:striprWrcrrI)r r,rSrrrWrss rr=_VolumeType.generate_helpsii ,,];AAC O,;+@+@+B+BO$B'Hii ,,];AAC O ,;+@+@+B+BO$B'H H O O XXZ HHJ P r"r4N)__name__ __module__ __qualname____firstlineno____doc__ classmethodabcabstractmethodrrIr;rSrWr(r1r'rrNGAr&r=__static_attributes__r4r"rrDrDws@    ))      595F5F5I5I8r"rDc\rSrSrSr\S5r\S5r\S5r\S5r \S5r \S5r \S 5r S r g ) _InMemoryVolumez/Volume Type representing an in-memory emptydir.cg)Nz in-memoryr4rs rr_InMemoryVolume.names r"cg)NzAn ephemeral volume that stores data in the instance's memory. With this type of volume, data is not shared between instances and all data will be lost when the instance it is on is terminated.r4rs rrI_InMemoryVolume.help  Jr"c>[RR5$NrMrs rr;_InMemoryVolume.release_trackss    & & ((r"c0$rr4rRs rrS_InMemoryVolume.required_fields Ir"cRU[RR:XaSSSS.$SS0$)NThe name of the volume. A name will be generated if the `mount-path` flag is specified. A name is required if `mount-path` is not specified. The path at which the volume should be mounted. The `mount-path` parameter is only supported for single container services which do not make use of the --container flag. For multi-container services, specify the `mount-path` parameter under the --add-volume-mount flag.a7A quantity representing the maximum amount of memory allocated to this volume, such as "512Mi" or "3G". Data stored in an in-memory volume consumes the memory allocation of the container that wrote the data. If size-limit is not specified, the maximum size will be half the total memory limit of all containers.)r mount-pathr r rrNALPHArRs rrW_InMemoryVolume.optional_fieldssD))///0 *.  A r"cbSU;aURSUSS9nOURSS9nXBlg)Nr Memorymedium sizeLimitrEmptyDirVolumeSourceemptyDirr r)r-r+srcs rr(_InMemoryVolume.fill_volume&sDv  ) )VL%9 * c  ) ) ) :cr"cURURRRS9nSU;a USUlUR USUS9$)Nrr r)r empty_dir)rMediumMEMORY size_limitr%)r r)rsources rr1 _InMemoryVolume.create_volume_v20sc  ' '))0077(Fv .f << F^  r"r4N)rvrwrxryrzr{rrIr;rSrWr(r1rr4r"rrrs7))  D  r"rcx\rSrSrSr\S5r\S5r\S5r\S5r \S5r \S5r S r g ) _TempDiskVolumei=z0Volume Type representing a disk-backed emptydir.cg)Nzephemeral-diskr4rs rr_TempDiskVolume.nameAs r"cg)NzA volume that stores data on a temporary disk. With this type of volume, data is not shared between instances and all data will be lost when the instance it is on is terminated.r4rs rrI_TempDiskVolume.helpErr"c8[RR/$rrrs rr;_TempDiskVolume.release_tracksM    # # $$r"c0$rr4rRs rrS_TempDiskVolume.required_fieldsQrr"cSSSS.$)NrrzcA quantity representing the amount of disk space allocated to this volume, such as "512Mi" or "3G".)rrsizer4rRs rrW_TempDiskVolume.optional_fieldsUs .  ( 5 r"cbSU;aURSUSS9nOURSS9nXBlg)NrDiskrrrrs rr(_TempDiskVolume.fill_volumejsC   ) )6&> * c  ) ) ) 8cr"r4N) rvrwrxryrzr{rrIr;rSrWr(rr4r"rrr=s{8%%(r"rc\rSrSrSr\S5r\S5r\S5r\S5r \S5r \S5r \S 5r S r g ) _NfsVolumeiuz'Volume Type representing an NFS volume.cg)Nnfsr4rs rr_NfsVolume.nameys r"cg)Nz,Represents a volume backed by an NFS server.r4rs rrI_NfsVolume.help} 9r"c SS0$)Nr z8The location of the NFS Server, in the form SERVER:/PATHr4rRs rrS_NfsVolume.required_fieldss N r"cRU[RR:XaSSSS.$SS0$)NrrBA boolean. If true, this volume will be read-only from all mounts.)rrreadonlyrrrRs rrW_NfsVolume.optional_fieldssA))///0 *&  P r"cjUSnSU;a([R"SRUS55eg)Nr :/zEVolume {}: field 'location' must be of the form IP_ADDRESS:/DIRECTORYr)rrbrc)r r)r,r s rr'_NfsVolume.validate_fieldss?j!H 8 ! 4 4 ##)6&.#9 r"c~[U5nUSRSS5upVSU-nURXVUS9nXrlg)Nr r/)serverrreadOnly) _is_readonlysplitNFSVolumeSourcer)r r)r-r+rrrrs rr(_NfsVolume.fill_volumesHF#H*%++D!4LF :D  " "&h " OCKr"c [U5nUSn[U5RSS5upVSU-nURUSUR UUUS9S9$)Nr rrrr)rr read_only)rr)rstrrr%r)r r)rrr rrs rr1_NfsVolume.create_volume_v2spF#Hj!Hx=&&tQ/LF :D << F^  ! ! "   r"r4N)rvrwrxryrzr{rrIrSrWr'r(r1rr4r"rrrus/:: 4  r"rc\rSrSrSr\S5r\S5r\S5r\S5r \S5r \S5r \S 5r S r g ) _GcsVolumeiz&Volume Type representing a GCS volume.cg)Nz cloud-storager4rs rr_GcsVolume.names r"cg)NzA volume representing a Cloud Storage bucket. This volume type is mounted using Cloud Storage FUSE. See https://cloud.google.com/storage/docs/gcs-fuse for the details and limitations of this filesystem.r4rs rrI_GcsVolume.helps  .r"c\U[RR:Xa`[R"5nU"UR SS55nU(aSU;d U(dSU;a[R"S5eggg![ Ra [R"S5ef=f)Nr falsez.dynamic-mounting must be set to true or false.r z7Either set bucket or enable dynamic-mounting, not both.) rrNrr ArgBooleangetargparseArgumentTypeErrorrrb)r r)r, bool_parserdynamic_mountings rr'_GcsVolume.validate_fieldss))/// !,,. &vzz2Dg'NO x6186#9#66 E  $:0 ' ' #66 <   s -B+B+cJU[RR:Xa0$SS0$)Nr z:the name of the bucket to use as the source of this volumerrRs rrS_GcsVolume.required_fieldss+))/// iN r"ctSSS.nU[RR:XaSUS'SUS'SUS 'S US 'U$) NrzqA list of flags to pass to GCSFuse. Flags should be specified without leading dashes and separated by semicolons.)rrz;the name of the bucket to use as the source of this volume.r zA boolean. If true, the volume will be mounted dynamically. Note: You will either need to specify a bucket or set dynamic-mounting to true, but not both.r rrrrr)r r,fieldss rrW_GcsVolume.optional_fieldssk Q  F))/// G X 6   , Vn  & \ Mr"c URS[U5S9nURR5UlSU;aJURRR URRR SUSS95 SU;aZURRR URRR SUSRSS 5S95 S U;aQUS (aGURRR URRR SS S95 XBlg) Nzgcsfuse.run.googleapis.com)driverrr bucketNamer8valuer mountOptions;,r r@) CSIVolumeSourcerVolumeAttributesValuevolumeAttributesadditionalPropertiesr<AdditionalPropertyreplacecsirs rr(_GcsVolume.fill_volumes:  " "+l66J # C$33IIKC6 //66  " " 8 8 K KfX&6 L  &  //66  " " 8 8 K K ?+33C= L  V#/A(B //66  " " 8 8 K Kc L  Kr"cSU;aUSRS5nO/nUR[U5US9nSU;aUS(aSUlO USUlUR USUS9$) Nrr)r mount_optionsr r@r r)rgcs)rGCSVolumeSourcerr r%)r r)rrrs rr1_GcsVolume.create_volume_v2.s& _-33C8mm  " "v&##F V#/A(BfmX&fm << F^   r"r4N)rvrwrxryrzr{rrIr'rSrWr(r1rr4r"rrrs.  !!F4r"rc\rSrSrSr\S5r\S5r\S5r\S5r \S5r \S5r \S 5r S r g ) SecretVolumeiDz Represents a secret as a volume.c8[RR/$rrrs rr;SecretVolume.release_tracksHrr"cg)Nrr4rs rrSecretVolume.nameLs r"cg)Nz9Represents a secret stored in Secret Manager as a volume.r4rs rrISecretVolume.helpPs Fr"cSSSS.$)NzThe name of the secret in Secret Manager. Must be a secret in the same project being deployed or be an alias mapped in the `run.googleapis.com/secrets` annotation.z:The version of the secret to make available in the volume.z:The relative path within the volume to mount that version.)rrrr4rRs rrSSecretVolume.required_fieldsTs 8PL r"c SSS.$Nrr)rrr4rRs rrWSecretVolume.optional_fields`s .  (  r"cURUSS9nURUSUSS9nURRU5 XBlg)Nr) secretNamerr)rr8)SecretVolumeSource KeyToPathr:r<r)r r)r-r+ritems rr(SecretVolume.fill_volumeqsO  % %1A % BC   6&>vi7H  IDIITNr"c tURUSURUSURUSUSS9/S9S9$)Nrrrr)rr)rr:)rr)r%r VersionToPath)r r)rs rr1SecretVolume.create_volume_v2xs` << F^''(###"9-F6N$(    r"r4N)rvrwrxryrzr{r;rrIrSrWr(r1rr4r"rrrDs(%%GG      r"rc\rSrSrSr\S5r\S5r\S5r\S5r \S5r \S5r \S 5r \S 5r S rg ) CloudSqlInstancei,Represents a Cloud SQL instance as a volume.c8[RR/$rrrs rr;CloudSqlInstance.release_tracksrr"cg)Ncloudsqlr4rs rrCloudSqlInstance.names r"cg)Nrr4rs rrICloudSqlInstance.helprr"cUSRS5HGnUR5RS5n[U5S:wdM3[R"S5e g)Nrr:zECloud SQL instances must be in the form project_id:region:instance_id)rrtlenrrb)r r)r,instances rr' CloudSqlInstance.validate_fieldssW;'--c2!'',h X! #66 -  3r"c SS0$)Nrz|The name of the Cloud SQL instances to mount. Must be in the form project_id:region:instance_id and separated by semicolons.r4rRs rrS CloudSqlInstance.required_fieldss  J r"cLU[RR:XaSSS.$0$r rrRs rrW CloudSqlInstance.optional_fieldss1))///0 *   Ir"c ,URSS9nURR5UlSU;aZURRR URRR SUSR SS5S95 XBlg)Nzcloudsql.run.googleapis.com)rrrrr)rrrrr<rrrrs rr(CloudSqlInstance.fill_volumes  " "*G " HC#33IIKCf //66  " " 8 8 K K;'//S9 L  Kr"c URUSURUSRS5Vs/sHo3R5PM snS9S9$s snf)Nrrr)r)rcloud_sql_instance)r%rrrt)r r)rr$s rr1!CloudSqlInstance.create_volume_v2sd << F^ 1117 1D1J1J31O1OX 1O2   sAr4N)rvrwrxryrzr{r;rrIr'rSrWr(r1rr4r"rrrs4%%::  $  r"rcFSU;=(a USR5S:H$)Nrtrue)lower)r)s rrrs% v  F&"4":":"<"FFr"cU[RR:Xa9SU;a[R"S5eSU;a[R"S5eO"SU;dSU;a[R"S5eUS[ ;a([R"SR US55e[ USnXR5;a([R"SR US55eg)z#Validates the volume name and type.r z"All added volumes must have a typerzAVolume "name" must be specified if "mount-path" is not specified.z+All added volumes must have a name and typezVolume type {} not supportedN)rrNrrrbrrcr;)r)r,r.s rr$r$sd''--- V ! 4 4 .  V ! 4 4 M  VvV3 ! 4 4 7  F^22  2 2&--fVn= %VF^ 4(1133  2 2&--fVn= 4r")rzr|rtypingrgooglecloudsdk.callioperrgooglecloudsdk.command_lib.runrrrrrrr!r/rNrr1rBABCrDrrrrrrrr$r4r"rr7so* /(N   ! (7&   $(,'8'8'>'> 2  2$$ 2 q#''qhNkNNb4k44nLLL^{{{|?;??DK{KK\Gr"