VhdddlmZmZmZeZdZdZdZddl m Z m Z ddl m Z ddl mZddlmZd d lmZmZd ZGd d eZdZedk(reyy))absolute_importdivisionprint_functionu --- module: server short_description: Manages servers on the cloudscale.ch IaaS service description: - Create, update, start, stop and delete servers on the cloudscale.ch IaaS service. notes: - If I(uuid) option is provided, it takes precedence over I(name) for server selection. This allows to update the server's name. - If no I(uuid) option is provided, I(name) is used for server selection. If more than one server with this name exists, execution is aborted. - Only the I(name) and I(flavor) are evaluated for the update. - The option I(force=true) must be given to allow the reboot of existing running servers for applying the changes. author: - Gaudenz Steinlin (@gaudenz) - René Moser (@resmo) - Denis Krienbühl (@href) version_added: "1.0.0" options: state: description: - State of the server. choices: [ running, stopped, absent ] default: running type: str name: description: - Name of the Server. - Either I(name) or I(uuid) are required. type: str uuid: description: - UUID of the server. - Either I(name) or I(uuid) are required. type: str flavor: description: - Flavor of the server. type: str image: description: - Image used to create the server. type: str zone: description: - Zone in which the server resides (e.g. C(lpg1) or C(rma1)). type: str volume_size_gb: description: - Initial size of the root volume in GB. - This parameter has no effect on existing servers. - Use the volume module to change the size of the root volume. default: 10 type: int bulk_volume_size_gb: description: - Size of the bulk storage volume in GB. - No bulk storage volume if not set. type: int ssh_keys: description: - List of SSH public keys. - Use the full content of your .pub file here. type: list elements: str password: description: - Password for the server. type: str use_public_network: description: - Attach a public network interface to the server. type: bool use_private_network: description: - Attach a private network interface to the server. type: bool use_ipv6: description: - Enable IPv6 on the public network interface. default: true type: bool interfaces: description: - List of network interface objects specifying the interfaces to be attached to the server. See U(https://www.cloudscale.ch/en/api/v1/#interfaces-attribute-specification) for more details. type: list elements: dict version_added: 1.4.0 suboptions: network: description: - Create a network interface on the network identified by UUID. Use 'public' instead of an UUID to attach a public network interface. Can be omitted if a subnet is provided under addresses. type: str addresses: description: - Attach a private network interface and configure a subnet and/or an IP address. type: list elements: dict suboptions: subnet: description: - UUID of the subnet from which an address will be assigned. type: str address: description: - The static IP address of the interface. Use '[]' to avoid assigning an IP address via DHCP. type: str server_groups: description: - List of UUID or names of server groups. type: list elements: str user_data: description: - Cloud-init configuration (cloud-config) data to use for the server. type: str force: description: - Allow to stop the running server for updating if necessary. default: false type: bool tags: description: - Tags assosiated with the servers. Set this to C({}) to clear any tags. type: dict extends_documentation_fragment: cloudscale_ch.cloud.api_parameters aW # Create and start a server with an existing server group (shiny-group) - name: Start cloudscale.ch server cloudscale_ch.cloud.server: name: my-shiny-cloudscale-server image: debian-10 flavor: flex-4-4 ssh_keys: - ssh-rsa XXXXXXXXXX...XXXX ansible@cloudscale server_groups: shiny-group zone: lpg1 use_private_network: true bulk_volume_size_gb: 100 api_token: xxxxxx # Start another server in anti-affinity (server group shiny-group) - name: Start second cloudscale.ch server cloudscale_ch.cloud.server: name: my-other-shiny-server image: ubuntu-16.04 flavor: flex-8-2 ssh_keys: - ssh-rsa XXXXXXXXXX...XXXX ansible@cloudscale server_groups: shiny-group zone: lpg1 api_token: xxxxxx # Force to update the flavor of a running server - name: Start cloudscale.ch server cloudscale_ch.cloud.server: name: my-shiny-cloudscale-server image: debian-10 flavor: flex-8-2 force: true ssh_keys: - ssh-rsa XXXXXXXXXX...XXXX ansible@cloudscale use_private_network: true bulk_volume_size_gb: 100 api_token: xxxxxx register: server1 # Stop the first server - name: Stop my first server cloudscale_ch.cloud.server: uuid: '{{ server1.uuid }}' state: stopped api_token: xxxxxx # Delete my second server - name: Delete my second server cloudscale_ch.cloud.server: name: my-other-shiny-server state: absent api_token: xxxxxx # Start a server and wait for the SSH host keys to be generated - name: Start server and wait for SSH host keys cloudscale_ch.cloud.server: name: my-cloudscale-server-with-ssh-key image: debian-10 flavor: flex-4-2 ssh_keys: - ssh-rsa XXXXXXXXXX...XXXX ansible@cloudscale api_token: xxxxxx register: server until: server is not failed retries: 5 delay: 2 # Start a server with two network interfaces: # # A public interface with IPv4/IPv6 # A private interface on a specific private network with an IPv4 address - name: Start a server with a public and private network interface cloudscale_ch.cloud.server: name: my-cloudscale-server-with-two-network-interfaces image: debian-10 flavor: flex-4-2 ssh_keys: - ssh-rsa XXXXXXXXXX...XXXX ansible@cloudscale api_token: xxxxxx interfaces: - network: 'public' - addresses: - subnet: UUID_of_private_subnet # Start a server with a specific IPv4 address from subnet range - name: Start a server with a specific IPv4 address from subnet range cloudscale_ch.cloud.server: name: my-cloudscale-server-with-specific-address image: debian-10 flavor: flex-4-2 ssh_keys: - ssh-rsa XXXXXXXXXX...XXXX ansible@cloudscale api_token: xxxxxx interfaces: - addresses: - subnet: UUID_of_private_subnet address: 'A.B.C.D' # Start a server with two network interfaces: # # A public interface with IPv4/IPv6 # A private interface on a specific private network with no IPv4 address - name: Start a server with a private network interface and no IP address cloudscale_ch.cloud.server: name: my-cloudscale-server-with-specific-address image: debian-10 flavor: flex-4-2 ssh_keys: - ssh-rsa XXXXXXXXXX...XXXX ansible@cloudscale api_token: xxxxxx interfaces: - network: 'public' - network: UUID_of_private_network addresses: [] aB href: description: API URL to get details about this server returned: success when not state == absent type: str sample: https://api.cloudscale.ch/v1/servers/cfde831a-4e87-4a75-960f-89b0148aa2cc uuid: description: The unique identifier for this server returned: success type: str sample: cfde831a-4e87-4a75-960f-89b0148aa2cc name: description: The display name of the server returned: success type: str sample: its-a-me-mario.cloudscale.ch state: description: The current status of the server returned: success type: str sample: running flavor: description: The flavor that has been used for this server returned: success when not state == absent type: dict sample: { "slug": "flex-4-2", "name": "Flex-4-2", "vcpu_count": 2, "memory_gb": 4 } image: description: The image used for booting this server returned: success when not state == absent type: dict sample: { "default_username": "ubuntu", "name": "Ubuntu 18.04 LTS", "operating_system": "Ubuntu", "slug": "ubuntu-18.04" } zone: description: The zone used for booting this server returned: success when not state == absent type: dict sample: { 'slug': 'lpg1' } volumes: description: List of volumes attached to the server returned: success when not state == absent type: list sample: [ {"type": "ssd", "device": "/dev/vda", "size_gb": "50"} ] interfaces: description: List of network ports attached to the server returned: success when not state == absent type: list sample: [ { "type": "public", "addresses": [ ... ] } ] ssh_fingerprints: description: A list of SSH host key fingerprints. Will be null until the host keys could be retrieved from the server. returned: success when not state == absent type: list sample: ["ecdsa-sha2-nistp256 SHA256:XXXX", ... ] ssh_host_keys: description: A list of SSH host keys. Will be null until the host keys could be retrieved from the server. returned: success when not state == absent type: list sample: ["ecdsa-sha2-nistp256 XXXXX", ... ] server_groups: description: List of server groups returned: success when not state == absent type: list sample: [ {"href": "https://api.cloudscale.ch/v1/server-groups/...", "uuid": "...", "name": "db-group"} ] tags: description: Tags assosiated with the server. returned: success type: dict sample: { 'project': 'my project' } )datetime timedelta)sleep)deepcopy) AnsibleModule)AnsibleCloudscaleBasecloudscale_argument_spec)runningstoppedabsentc|eZdZfdZdZddZedZdZddZ ddZ dZ d Z d Z d Zd Zd ZdZxZS)AnsibleCloudscaleServerc:tt| |i|_y)N)superr__init___info)selfmodule __class__s n/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cloudscale_ch/cloud/plugins/modules/server.pyrz AnsibleCloudscaleServer.__init__[s %t5f= c|jjjdxs|jjd|jjjdxs|jjdddS)Nuuidnamer)rrstate)_moduleparamsgetr)rs r_init_server_containerz.AnsibleCloudscaleServer._init_server_containerascLL''++F3Mtzz~~f7MLL''++F3Mtzz~~f7M  rc|jr|s |jS|j|_|jjd}|8|jd|z}|r|j ||_|jS|jjd}||jdxsg}g}|D]}|d|k(s |j |t |dk(r%|j |d|_|jSt |dkDr|jjd|z|jS) Nr servers/%srserversrz\More than one server with name '%s' exists. Use the 'uuid' parameter to identify the server.msg) rr#r"_get_transform_stateappendlenr fail_json)rrefreshr server_inforr&matching_serverservers r_get_server_infoz(AnsibleCloudscaleServer._get_server_infohs> ::g:: 002 zz~~f%  ))L4$78K!22;? "zz::>>&)D))I.4""$%7Ff~-'..v67'1,!%!6!6q7I!JDJ zz )A-LL**0^`d0e*fzzrc2d|vr |d|d<|d=|Sd|d<|S)Nstatusrr)r2s rr+z(AnsibleCloudscaleServer._transform_states7 v $X.F7Ox  'F7O rctj}|jjddz}tj|z t |krW|j d}|j d|vr|Stdtj|z t |krWj d+d |j dd |d |j dd }nQ|jjj dxs%|jjj d }d|z}|jj|y)N api_timeoutr )secondsT)r/rr'rz3Timeout while waiting for a state change on server z to states z. Current state is .rz+Timeout while waiting to find the server %sr() rnowr r!rr3r"rr.)rstatesstarttimeoutr0r) name_uuids r_wait_for_statez'AnsibleCloudscaleServer._wait_for_states ,,%%m4q8llnu$y'AA///=Kw'61"" !H llnu$y'AA ??6 " .,7OOF,CV[__]dMegC ++//7Z4<<;N;N;R;RSY;ZI?)KC 3'rcddd}|jd}||k7rd|jd<|sU|jddjd|jdi|jdd jd|i|jjs/|j d |d d |||j |f}|S) Nstopr=rrrTchangeddiffbeforeafterzservers/r/)r"_resultupdater check_mode_postr@)rr0 target_state ignore_diffactions server_states r_start_stop_serverz*AnsibleCloudscaleServer._start_stop_servers  #w/ < '&*DLL # V$X.55[__W57 V$W-44\6<<** k&.A7> K#223IJ rc|jjd}|syg}g}|jd}|D]}|d|vr)|j|d|j |d3|d|vr=|j|d|j |d|j|dw|d|vs|jj d|dz|r.|jj ddj |z|S) N server_groupsz server-groupsrrziMore than one server group with name exists: '%s'. Use the 'uuid' parameter to identify the server group.r(z'Server group name or UUID not found: %sz, )r r!r*r,remover.join)rserver_group_paramsmatching_group_namesresultsr_ server_groups r_get_server_group_idsz-AnsibleCloudscaleServer._get_server_group_idss+"ll11/B"! /2 ) xLF#'::|F34#**<+?@f%)<<|F34#**<+?@$++L,@Af%)== &&,`bnoubv,w&x x  LL " "'PSWS\S\]pSq'q " rrcd|jd<|jt|jj}dD]}||=|j |d<|j |jdd<t||jdd<|jjs#|jd||jd }|S) NTrD)rrrTr8 api_tokenapi_urlr_rErFrGr&)r) rInormalize_interfaces_paramr r r!rfr#rKrLr@)rr0datais r_create_serverz&AnsibleCloudscaleServer._create_servers"& Y '') ++,R AQ  $ : : <_)-)D)D)F VX&(0 VW%||&& JJy$ '..}=Krc |jd}|j}|5|dDcgc]}|d }}||k7r|jjd|j |jj jd}|jd} |j || }r6|jd|}|jd s|d|k7|jd <|jd |d }|jd |}|jd|}|dk(r|j|dd }|Scc}w#t$r6} |jjd| jdzYd} ~ d} ~ wwxYw)Nrr_rzMServer groups can not be mutated, server needs redeployment to change groups. interfacesz,Error checking 'interfaces', missing key: %srr(rDflavorT)rYrtagsrrU) r"rfr rVrjr!has_wanted_interfacesKeyErrorr.argsr]rIrQ) rr0previous_statedesired_server_group_idsgrpcurrent_server_group_idswantedactualupdate_interfaceses r_update_serverz&AnsibleCloudscaleServer._update_server s$1$(#=#=#? # /?J??['\F '\ $'\'+CC !!"qr '') $$((6. P$($>$>vv$N N  ,,\;GK<< **5l*Cv*M Y'((;d(S ((= ((= Y &11+Icg1hKA(] P LL " "BQVVAYN # P P Ps D> E F ,E==Fc|j}|jddk7r|jjjddk(r|j |d}|j |}|jjjddk(r|j |d}|S|j |}|j ||jjjd}|S)Nrrr)rMr)r3r"r r!rQr}rmrr0s rpresent_serverz&AnsibleCloudscaleServer.present_server7s++- ??7 #x /||""&&w/9<"55kPY5Z --k:K||""&&w/9<"55kPY5Z --k:K11+DLLL_L_LcLcdkLl1mKrc^|j}|jddk7rd|jd<t||jdd<|j |jdd<|j j s(|jd|d z|jd }|S) NrrTrDrErFrGr%r)r) r3r"rIr r#r rK_deleter@rs r absent_serverz%AnsibleCloudscaleServer.absent_serverJs++- ??7 #x /&*DLL #-5k-BDLL  *,0,G,G,IDLL  )<<** \K,??@"22<@ rcrt|xsdtxsdk7ryfd}|D] }||r yy)zs Compares the interfaces as specified by the user, with the interfaces as reported by the server. r6FcD]}|jddk(r |ddk(rnm|jd|ddk(r|dd|dk(rnDtd|jdxsdD}td |dD}||k(sny |jdxsdD]%}d |vrtd |dD}|d |vs%y |jdgk(r |dgk7ry |dgk(r|jdgk7ry |S) Nnetworkpublictypeprivaterc3&K|] }|d yw)subnetNr6.0as r zYAnsibleCloudscaleServer.has_wanted_interfaces..match_interface..os(H$%AhK(H addressesr6c3,K|] }|ddyw)rrNr6rs rrzYAnsibleCloudscaleServer.has_wanted_interfaces..match_interface..rs (I,-AhK'(IsFaddressc3&K|] }|d yw)rNr6rs rrzYAnsibleCloudscaleServer.has_wanted_interfaces..match_interface..sM) Mr)r"set)spec interfacewanted_subnet_idsactual_subnet_ids wanted_addrrrzs rmatch_interfacezFAnsibleCloudscaleServer.has_wanted_interfaces..match_interface^sg$  88I&(2 (H488I&2 (I5$Y/74 ?J!%((H*.((;*?*E2(H%H!%((I1:;1G(I%I!%(99+ .!% 5 ; ! K/Mi 6LMM y):  !xx $*y/E/K%+0E0K rT)r-)rryrzrrs ` rrrz-AnsibleCloudscaleServer.has_wanted_interfacesUsK v| FLb 1 1/ b D#4(  rc|jjjdxsdD]=}|d|d=|d|d=|jdxsdD]}|d|d=|d|d=?y)zX Goes through the interfaces parameter and gets it ready to be sent to the API. ror6rNrrr)r r!r")rrrs rrjz2AnsibleCloudscaleServer.normalize_interfaces_params\\((,,\:@b *DK (%I&O HH[17R *9%- *8$,)  * *r)F)rF)__name__ __module__ __qualname__rr#r3 staticmethodr+r@rQr]rfrmr}rrrrrj __classcell__)rs@rrrYs\  :(&.&P: (T& AF*rrct}|jtd(idtdtdtdtdtdtdtd td d d td dtddddtddtddtddtdd dtddttdtddttdtdd tdd!d"td#tdd d$tdt |ddgddgfd%d&}t |}|j dd'k(r|j}n|j}|j|}|jd(i|y))Nrr)defaultchoicesrrrpimagezonevolume_size_gbint )rrbulk_volume_size_gb)rssh_keysliststrF)relementsno_logpasswordT)ruse_public_networkbooluse_private_networkuse_ipv6rodict)rr)rroptions)rrr_)rr user_datarTrq))rr) argument_specmutually_exclusiverequired_one_ofsupports_check_moderr6) r rJrALLOWED_STATESr rr!rr get_result exit_json)rrcloudscale_serverr2results rmainrs,.M!9n=! V!V!v ! f ! V !3!!e,!6E%@!T"! V,!!f-!640!%(# $% 0#/  !:7;!<&=!>.?!@v A!!F# / 0 0 1 , F07 }}W)"002"113  ) )& 1FFvr__main__N) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNrrtimercopyr ansible.module_utils.basicr module_utils.apir r rrrrr6rrrsrA@  Bv pB H)4  M*3M*` 6r zFr