Vh DddlmZmZmZeZdZdZdZddl m Z ddl m Z ddl mZGd d e Zd Zed k(rey y ))absolute_importdivisionprint_functionu --- module: instance short_description: Manages server instances on Vultr. description: - Manage server instances on Vultr. version_added: "1.1.0" author: - "René Moser (@resmo)" options: label: description: - Name of the instance. required: true aliases: [ name ] type: str hostname: description: - The hostname to assign to this instance. type: str os: description: - The operating system name. - Mutually exclusive with I(image) and I(app). type: str app: description: - The app deploy name of Vultr OneClick apps. - Mutually exclusive with I(image) and I(os). type: str image: description: - The image deploy name of Vultr Marketplace apps. - Mutually exclusive with I(os) and I(app). type: str firewall_group: description: - The firewall group description to assign this instance to. type: str plan: description: - The plan name to use for the instance. - Required if the instance does not yet exist. type: str activation_email: description: - Whether to send an activation email when the instance is ready or not. - Only considered on creation. type: bool default: false backups: description: - Whether to enable automatic backups or not. type: bool ddos_protection: description: - Whether to enable ddos_protection or not. type: bool enable_ipv6: description: - Whether to enable IPv6 or not. type: bool tags: description: - Tags for the instance. type: list elements: str user_data: description: - User data to be passed to the instance. type: str user_scheme: description: - The user scheme used as login user (Linux-only). - By default, the I(root) user is configured. - Only considered while creating the instance. type: str choices: [ root, limited ] version_added: "1.11.0" startup_script: description: - Name or ID of the startup script to execute on boot. - Only considered while creating the instance. type: str ssh_keys: description: - List of SSH key names passed to the instance on creation. type: list elements: str snapshot: description: - Description or ID of the snapshot. - Only considered while creating the instance. type: str version_added: "1.7.0" reserved_ipv4: description: - IP address of the floating IP to use as the main IP of this instance. - Only considered on creation. type: str region: description: - Region the instance is deployed into. type: str required: true vpcs: description: - A list of VPCs identified by their description to be assigned to the instance. type: list elements: str version_added: "1.5.0" skip_wait: description: - Whether to skip the wait for the instance to be completely ready for access. type: bool default: false version_added: "1.13.0" state: description: - State of the instance. - The state I(reinstalled) was added in version 1.8.0. default: present choices: [ present, absent, started, stopped, restarted, reinstalled ] type: str extends_documentation_fragment: - vultr.cloud.vultr_v2 a --- - name: Create an instance using OS vultr.cloud.instance: label: my web server hostname: my-hostname user_data: | #cloud-config packages: - nginx firewall_group: my firewall group plan: vc2-1c-2gb ddos_protection: true backups: true enable_ipv6: true ssh_keys: - my ssh key vpcs: - my vpc description tags: - web - project-genesis region: ams os: Debian 12 x64 (bookworm) - name: Deploy an instance of a marketplace app vultr.cloud.instance: label: git-server hostname: git firewall_group: my firewall group plan: vc2-1c-2gb ddos_protection: true backups: true enable_ipv6: true region: ams image: Gitea on Ubuntu 20.04 - name: Stop an existing instance vultr.cloud.instance: label: my web server region: ams state: stopped - name: Start an existing instance vultr.cloud.instance: label: my web server region: ams state: started - name: Reinstall an instance vultr.cloud.instance: label: my web server region: ams state: reinstalled - name: Delete an instance vultr.cloud.instance: label: my web server region: ams state: absent aY --- vultr_api: description: Response from Vultr API with a few additions/modification. returned: success type: dict contains: api_timeout: description: Timeout used for the API requests. returned: success type: int sample: 60 api_retries: description: Amount of max retries for the API requests. returned: success type: int sample: 5 api_retry_max_delay: description: Exponential backoff delay in seconds between retries up to this max delay value. returned: success type: int sample: 12 api_endpoint: description: Endpoint used for the API requests. returned: success type: str sample: "https://api.vultr.com/v2" vultr_instance: description: Response from Vultr API. returned: success type: dict contains: id: description: ID of the instance. returned: success type: str sample: cb676a46-66fd-4dfb-b839-443f2e6c0b60 v6_main_ip: description: IPv6 of the instance. returned: success type: str sample: "" v6_network: description: IPv6 network of the instance. returned: success type: str sample: "" v6_network_size: description: IPv6 network size of the instance. returned: success type: int sample: 0 main_ip: description: IPv4 of the instance. returned: success type: str sample: 95.179.189.95 netmask_v4: description: Netmask IPv4 of the instance. returned: success type: str sample: 255.255.254.0 hostname: description: Hostname of the instance. returned: success type: str sample: vultr.guest internal_ip: description: Internal IP of the instance. returned: success type: str sample: "" gateway_v4: description: Gateway IPv4. returned: success type: str sample: 95.179.188.1 kvm: description: KVM of the instance. returned: success type: str sample: "https://my.vultr.com/subs/vps/novnc/api.php?data=..." disk: description: Disk size of the instance. returned: success type: int sample: 25 allowed_bandwidth: description: Allowed bandwidth of the instance. returned: success type: int sample: 1000 vcpu_count: description: vCPUs of the instance. returned: success type: int sample: 1 firewall_group_id: description: Firewall group ID of the instance. returned: success type: str sample: "" plan: description: Plan of the instance. returned: success type: str sample: vc2-1c-1gb image_id: description: Image ID of the instance. returned: success type: str sample: "" os_id: description: OS ID of the instance. returned: success type: int sample: 186 app_id: description: App ID of the instance. returned: success type: int sample: 37 date_created: description: Date when the instance was created. returned: success type: str sample: "2020-10-10T01:56:20+00:00" label: description: Label of the instance. returned: success type: str sample: my instance region: description: Region the instance was deployed into. returned: success type: str sample: ews status: description: Status about the deployment of the instance. returned: success type: str sample: active server_status: description: Server status of the instance. returned: success type: str sample: installingbooting power_status: description: Power status of the instance. returned: success type: str sample: running ram: description: RAM in MB of the instance. returned: success type: int sample: 1024 os: description: OS of the instance. returned: success type: str sample: Application tags: description: Tags of the instance. returned: success type: list sample: [ my-tag ] features: description: Features of the instance. returned: success type: list sample: [ ddos_protection, ipv6, auto_backups ] user_data: description: Base64 encoded user data (cloud init) of the instance. returned: success type: str sample: I2Nsb3VkLWNvbmZpZwpwYWNrYWdlczoKICAtIGh0b3AK user_scheme: description: The user scheme to login into this instance returned: success type: str sample: root version_added: "1.11.0" backups: description: Whether backups are enabled or disabled. returned: success type: str sample: enabled version_added: "1.3.0" ddos_protection: description: Whether DDOS protections is enabled or not. returned: success type: bool sample: true version_added: "1.3.0" enable_ipv6: description: Whether IPv6 is enabled or not. returned: success type: bool sample: true version_added: "1.3.0" vpcs: description: List of VPCs attached. returned: success type: list version_added: "1.5.0" contains: id: description: ID of the VPC. returned: success type: str sample: 5536d2a4-66fd-4dfb-b839-7672fd5bc116 description: description: Description of the VPC. returned: success type: str sample: my vpc ip_address: description: IP assigned from the VPC. returned: success type: str sample: "192.168.23.3" mac_address: description: MAC address of the network interface. returned: success type: str sample: "5a:01:04:3d:5e:72" ) AnsibleModule)AnsibleVultrCommonInstance)vultr_argument_specc:eZdZddZfdZfdZfdZxZS)AnsibleVultrInstancec\||jjdk(r|d|k7s|rd|jd<|jjs`|j |dddgd }|j |j d ||jd |d |j |d|g| }|S)Nstate power_statusTchanged server_statusnonelocked!=resourcekeystatescmp/POST)pathmethod)rrr skip_wait)moduleparamsresult check_modewait_for_state api_query resource_pathresource_key_id)selfrr actionrforcer"s h/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/vultr/cloud/plugins/modules/instance.pyhandle_power_statusz(AnsibleVultrInstance.handle_power_statuss DKK&&w/ /Xn5MQ]5]af%)DKK ";;))..o_ego^pvz.{'+'9'98DDXDX;Y[ab! ..%&(>"00 / c tt| }|rC|jjsd|jj j ddk(r<|j|dddgd|jj j dd }|j|d d d |jj j dd }|j|d dd|jj j dd }|j|dddd|jj j dd }|j|ddddd}|S)Nr presentrrrrrF)rrrrrstoppedhalt)rr r'rr"startedstartrunning restartedrebootT)rr r'rr(r" reinstalled reinstall) superr create_or_updaterr!rgetr"r*r&r __class__s r)r8z%AnsibleVultrInstance.create_or_updatess-tEG ;;))dkk.@.@.D.DW.MQZ.Z..%'"H-"kk0044[%H ///!&#';;#5#5#9#9+u#MM 0H//!&#';;#5#5#9#9+u#MM 0H//!!&#';;#5#5#9#9+u#MM 0H//!#"&$ 0Hr+ctt| |jjddk7r|jjj d*|j d|jjd<|jjj d5|jjdrdnd|jjd<yyy) Nr absentfirewall_groupidfirewall_group_idbackupsenableddisabled)r7r configurerrr9get_firewall_group)r&r;s r)rDzAnsibleVultrInstance.configures "D35 ;;  g &( 2{{!!%%&67C:>:Q:Q:STX:Y ""#67{{!!%%i0<=A[[=O=OPY=Z `j ""9-= 3r+c|j}|r-|jjs|j|dddgd}tt ||S)Nrrrrr)r)queryrr!r"r7r r=r:s r)r=zAnsibleVultrInstance.absentsT::< DKK22**H/[ackZlrv*wH)477JJr+)FT)__name__ __module__ __qualname__r*r8rDr= __classcell__)r;s@r)r r s ",\kKKr+r c pt}|jtd3idtdddgdtddtdd tdd tdd tdd tdd tdddtddtddtddtdddtdddtddtddtddtddtddddtddd tdd!d"g#d$tddd%tgd&d'(t|d)d*d+}t |d,d-d.gd/gd0d1}|j j d%}|d2k(r|jy|jy)4NlabelstrTname)typerequiredaliaseshostname)rPappimagesnapshotosplanactivation_emailboolF)rPdefaultddos_protectionrA enable_ipv6tagslist)rPelementsvpcs reserved_ipv4r>startup_script user_datassh_keys)rPr`no_logregion)rPrQ user_schemerootlimited)rPchoicesrr )r-r=r0r.r3r5r-)rkr[))r r-)rX))rWrTrUrV) argument_spec required_ifmutually_exclusivesupports_check_modevultr_instancez /instancesinstance)rMrSrXapp_idos_idiso_idimage_id snapshot_id script_idrgr]rbr@rdr^rYr\ sshkey_idrA attach_vpcrh) rXr^r@r]r\rArdry detach_vpc)r namespacer$ressource_result_key_singularresource_create_param_keysresource_update_param_keysresource_key_namer=) r updatedictrr rr9r=r-)rlrvultrr s r)mainrs')M ! ED6(C! u%! % ! E" ! u% !  ! 5!! "vu=! !f-! f%! &)! 6E2! 6E2! E*!  U+!  U+!! "&#! $veD%! &UT2'! (%&)1DE)! *6+! ," -! #J#6@ F !""&0$ . $ "O( ET MM  g &E   r+__main__N) __future__rrrrP __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrmodule_utils.common_instancermodule_utils.vultr_v2r r rrHrr+r)rseA@ ~ @< |c L5E7OK5OKd\~ zFr+