x[hV(SrSSKrSSKrSSKJr SSKJrJrJrJ r J r J r J r SSK Jr SSKJr SSKJrJr SSKJr SSKJrJr \R2"\5r"SS 5r"S S 5r"S S 5r"SS5rS\ \\ \4S\ \ 4Sjr!g)z.Module for ephemeral network context managers N)partial)AnyCallableDictListLiteralOptionalTuple)NoDHCPLeaseErrormaybe_perform_dhcp_discovery)ProcessExecutionError)UrlError wait_for_urlcL\rSrSrSrS S\4SjjrSrSrSr S r S r S r g) EphemeralIPv4NetworkaContext manager which sets up temporary static network configuration. No operations are performed if the provided interface already has the specified configuration. This can be verified with the connectivity_urls_data. If unconnected, bring up the interface with valid ip, prefix and broadcast. If router is provided setup a default route for that interface. Upon context exit, clean up the interface leaving no configuration behind. Ninterface_addrs_before_dhcpc [X#XE/5(d[SRX#XE55e[R"U5UlX lX0lXPlXpl Xl /Ul Xl URSUR 3Ul URUR 05Ulg![a n [SRU 55U eSn A ff=f)aSetup context manager and validate call signature. @param interface: Name of the network interface to bring up. @param ip: IP address to assign to the interface. @param prefix_or_mask: Either netmask of the format X.X.X.X or an int prefix. @param broadcast: Broadcast address for the IPv4 network. @param router: Optionally the default gateway IP. @param static_routes: Optionally a list of static routes from DHCP z5Cannot init network on {0} with {1}/{2} and bcast {3}z4Cannot setup network, invalid prefix or netmask: {0}N/)all ValueErrorformatnetipv4_mask_to_net_prefixprefix interfaceip broadcastrouter static_routes cleanup_cmdsdistrocidrgetr) selfr"rrprefix_or_maskrrrr es 9/usr/lib/python3/dist-packages/cloudinit/net/ephemeral.py__init__EphemeralIPv4Network.__init__s*I>=>>GNN>   55nEDK#" *,. wwiq . +F+J+J NNB, ( %vay  sB77 C!CC!cUR5 UR(aUR 5 gUR (aUR5 gg![a=nS[UR5;aS[UR5;aeSnANSnAff=f![a URSSS5 ef=f)zSet up ephemeral network if interface is not connected. This context manager handles the lifecycle of the network interface, addresses, routes, etc z File existszAddress already assignedN) _bringup_devicer strstderrr _bringup_static_routesr_bringup_router__exit__)r%r's r( __enter__EphemeralIPv4Network.__enter__Ns  $$&&!!++-$$&))  HH)0AHH E  ,%  MM$d +  s3A!B"!B" B"3BB"BB""Cc8URH nU"5 M g)zTeardown anything we set up.N)r!)r% excp_type excp_valueexcp_tracebackcmds r(r1EphemeralIPv4Network.__exit__rs$$C E%c[RSURURUR5 [ R "5RUR05nURS5nURRS5nURURS05Vs/sHoDRS5PM sn;nURURRS05Vs/sHnURS5PM sn;nU(a,[RSURUR5 OEURRRURURUR5 U(a![RSUR5 O.URRRURSS9 U(a![RS UR5 OLURR[!URRR"URSS95 U(a![RS UR5 g URR[!URRR$URUR55 g s snfs snf) a6Perform the ip commands to fully set up the device. Dhcp clients behave differently in how they leave link state and ip address assignment. Attempt assigning address and setting up link if needed to be done. Set cleanup_cmds to return the interface state to how it was prior to execution of the dhcp client. z:Attempting setup of ephemeral network on %s with %s brd %supipv4rz1Skip adding ip address: %s already has address %sz9Skip bringing up network link: interface %s is already upinet)familyzLNot queueing link down: link [%s] was up prior before receiving a dhcp leasezSNot queueing address removal: address %s was assigned before receiving a dhcp leaseN)LOGdebugrr#rnetinfo netdev_infor$rrr"net_opsadd_addrlink_upr!appendr link_downdel_addr)r%interface_addrs_after_dhcphas_linkhad_linkrhas_iphad_ips r(r,$EphemeralIPv4Network._bringup_devicews< H NN II NN  &-%8%8%:%>%> NNB& ".11$73377=#=#A#A&"#M #MRFF4L#M  66::62F F FF4LF    IIC  KK   ( ( 4>>   IIK  KK   ' 'v ' F  II)     $ $KK''11NN!   II)     $ $KK''00$..$)) ]  s 1K9K!c *URHupURRRURX5 UR R S[URRRURUUS95 M g)Nrgateway) r r"rD append_routerr!insertr del_route)r% net_addressrRs r(r/+EphemeralIPv4Network._bringup_static_routess{%)$6$6 K KK   , ,      $ $KK''11NN#  %7r:c URRR5nSU;a0[R SUR UR 55 gURRRUR URURS9 URRS[URRRUR URURS95 URRRUR SURS9 URRS[URRRUR S55 g)z>9 M r:) rr#r!r"rrrrrr )NN) __name__ __module__ __qualname____firstlineno____doc__dictr)r2r1r,r/r0__static_attributes__r:r(rrs;$. &*. `"H GR0 r:rc*\rSrSrSrSrSrSrSrg)EphemeralIPv6NetworkzContext manager which sets up a ipv6 link local address The linux kernel assigns link local addresses on link-up, which is sufficient for link-local communication. c^U(d[SRU55eX lXlg)zSetup context manager and validate call signature. @param interface: Name of the network interface to bring up. @param ip: IP address to assign to the interface. @param prefix: IPv6 uses prefixes, not netmasks zCannot init network on {0}N)rrrr")r%r"rs r(r)EphemeralIPv6Network.__init__s(9@@KL L" r:c[R"URS5S:wa0URRR UR5 gg)zvlinux kernel does autoconfiguration even when autoconf=0 https://www.kernel.org/doc/html/latest/networking/ipv6.html operstater<N)r read_sys_netrr"rDrFr%s r(r2EphemeralIPv6Network.__enter__ s?   DNNK 8D @ KK   ' ' 7 Ar:cg)z%No need to set the link to down stateNrgr%_argss r(r1EphemeralIPv6Network.__exit__sr:)r"rN) r`rarbrcrdr)r2r1rfrgr:r(riris 84r:ricf\rSrSrS S\\\\\44Sjjr Sr Sr Sr Sr S rS rS rg) EphemeralDHCPv4iNconnectivity_urls_datacX lSUlSUlX@lU=(d /UlXl[ R"5UlgN) iface_ephipv4lease dhcp_log_funcrxr"rBrCr)r%r"r{rxr~s r(r)EphemeralDHCPv4.__init__s@ 8< /3 *&<&B# +2+>+>+@(r:c[UR5=n(a[RSU5 gUR 5$)zMSetup sandboxed dhcp context, unless connectivity_url can already be reached.z:Skip ephemeral DHCP setup, instance has connectivity to %sN)_check_connectivity_to_imdsrxr@rA obtain_lease)r%imds_reached_at_urls r(r2EphemeralDHCPv4.__enter__(sL#>  ' '#    II#    ""r:c$UR5 g)z Teardown sandboxed dhcp context.N) clean_network)r%r5r6r7s r(r1EphemeralDHCPv4.__exit__7s r:cpSUlUR(aURRSSS5 gg)z@Exit _ephipv4 context to teardown of ip configuration performed.N)r}r|r1rps r(rEphemeralDHCPv4.clean_network;s+ == MM " "4t 4 r:cUR(a UR$[URURUR5UlUR(d [ 5e[ RSURSURSURS5 SSSS/SQSS.nURU5nUS (d [R"US US 5US 'US (a+URRRUS 5US '[UR4S UR0UD6nUR5 X0lUR$)aPerform dhcp discovery in a sandboxed environment if possible. @return: A dict representing dhcp options on the most recent lease obtained from the dhclient discovery if run, otherwise an error is raised. @raises: NoDHCPLeaseError if no leases could be obtained. z#Received dhcp lease on %s for %s/%srz fixed-addressz subnet-maskzbroadcast-address)zrfc3442-classless-static-routeszclassless-static-routesr z unknown-121routers)rrr&rr rrr&rr r)r}r r"r{r~r r@rAextract_dhcp_options_mappingrmask_and_ipv4_to_bcast_addr dhcp_clientparse_static_routesrrr2r|)r%nmapkwargsephipv4s r(rEphemeralDHCPv4.obtain_leaseAsT :::: 1 KKT%7%7  zz"$ $ 1 JJ{ # JJ ' JJ} %  %!+,    2248k""%"A"A'(&,#F;  / " '';;?+ ? # ' KK (,(H(H    zzr:c0nUR5HKup4[U[5(aURX4U5 M.URR U5X#'MM U$rz)items isinstancelistget_first_option_valuer}r$)r%rresultinternal_referencelease_option_namess r(r,EphemeralDHCPv4.extract_dhcp_options_mappingxs\6:jjl 2 ,d33++&F.2ZZ^^>/+J( 2r:)r|rxr~r"r{rr})NNN)r`rarbrcr rrr-rr)r2r1rrrrrfrgr:r(rwrwsPAE A!)d38n)= > A #5 5n Kr:rwc \rSrSrSrSS\S\S\\\\ \ 44Sjjr Sr S \ S S \\\\44S jrS rSrg)EphemeralIPNetworkiaTCombined ephemeral context manager for IPv4 and IPv6 Either ipv4 or ipv6 ephemeral network may fail to initialize, but if either succeeds, then this context manager will not raise exception. This allows either ipv4 or ipv6 ephemeral network to succeed, but requires that error handling for networks unavailable be done within the context. Nipv6r=rxcX lX@lX0l[R"5UlSUlXlXPlg)a Args: distro: The distro object interface: The interface to bring up ipv6: Whether to bring up an ipv6 network ipv4: Whether to bring up an ipv4 network connectivity_urls_data: List of url data to use for connectivity check before attempting to bring up ephemeral networks. If connectivity can be established to any of the urls, then the ephemeral network setup is skipped. N) rr=r contextlib ExitStackstack state_msgr"rx)r%r"rrr=rxs r(r)EphemeralIPNetwork.__init__s5&#  ))+   &<#r:cUR(dUR(dU$/nSn[UR5=n(a[R SU5 U$[R S5 UR(a-UR SS9upEX$-nU(aURU5 UR(a-UR SS9upgX&-nU(aURU5 UR(aW(dUR(dSUlU(d[RS5 US eU$) NFz:We already have connectivity to IMDS at %s, skipping DHCP.z/No connectivity to IMDS, attempting DHCP setup.r=) ip_versionrzusing link-local ipv6zGFailed to bring up EphemeralIPNetwork. Datasource setup cannot continuer) r=rrrxr@rA _perform_ephemeral_network_setuprGrerror)r% exceptionsephemeral_obtainedimds_urlipv4_ephemeral_obtainedipv4_exceptionipv6_ephemeral_obtainedipv6_exceptions r(r2EphemeralIPNetwork.__enter__s$yyK "3  ' '  8  IIL K CD 99555H 4 #  9 !!.1 99555H 4 #  9 !!.1 II1$))4DN! II3 Q-  r:r)r=rreturncUS:Xa8URR[URURS95 ONUS:Xa:URR[ URUR55 O[ SU35e[RSURU5 g![[4a/n[RSURU5 SU4sS nA$S nAff=f) a Attempt to bring up an ephemeral network for the specified IP version. Args: ip_version (str): The IP version to bring up ("ipv4" or "ipv6"). Returns: Tuple: A tuple containing: - a boolean indicating whether an ephemeral network was successfully obtained - an optional exception if ephemeral network setup failed or None if successful r=)r"r{rzUnsupported IP version: z7Successfully brought up %s for ephemeral %s networking.)TNz2Failed to bring up %s for ephemeral %s networking.FN) r enter_contextrwr"rrirr@rAr r )r%rr's r(r3EphemeralIPNetwork._perform_ephemeral_network_setups" V# ((##{{"nn v% ((( !#;J =62h/N+/ tXi(( )/br:rrxrch^U4SjnT(d[RS5 g[ST55=(d Sn[TVs/sHo3SPM snUUSSS 9upEU(d[RS 5 gU$s snf![a n[RS U5 SnAgSnAff=f) ai Perform a connectivity check to the provided URLs to determine if the ephemeral network setup is necessary. This function attempts to reach one of the provided URLs and returns the URL that was successfully reached. If none of the URLs can be reached, it returns None. The timeout for the request is determined by the highest timeout value provided in the connectivity URLs data. If no timeout is provided, a default timeout of 5 seconds is used. Args: connectivity_urls_data: A list of dictionaries, each containing the following keys: - "url" (str): The URL to check connectivity for. - "headers" (dict, optional): Headers to include in the request. - "timeout" (int, optional): Timeout for the request in seconds. Returns: Optional[str]: The URL that was successfully reached, or None if no connectivity was established. cr>TVs/sHnUSU:XdMURS5PM! snSnU$s snf)zy Helper function to get headers for a given URL from the connectivity URLs data provided to _check_connectivity_to_imds. urlheadersrr$)rurl_datarrxs r( _headers_cb0_check_connectivity_to_imds.._headers_cb3sO3 2#% $HLL #2      s 44zZNo connectivity URLs provided. Skipping connectivity check before ephemeral network setup.Nc3D# UHoRSS5v M g7f)timeoutrNr).0rs r( ._check_connectivity_to_imds..Hs N7M8LLA & &7Ms rFr)urls headers_cbrconnect_synchronouslymax_waitz5Failed to reach IMDS without ephemeral network setup.z8Failed to reach IMDS without ephemeral network setup: %s)r@rAmaxrr)rxrrrurl_that_worked_r's` r(rrs6  "  J  N7M NN  )2HI2Hh5/2HI""'  . IIM N5J   F     s* B B BB B1B,,B1)"rdrlogging functoolsrtypingrrrrrr r cloudinit.netrcloudinit.netinforBcloudinit.net.dhcpr r cloudinit.subpr cloudinit.url_helperrr getLoggerr`r@rrirwrr-rrgr:r(rsFFF#M07 !b b J44@pKpKfJJZQ c3h0Q c]Qr: