Revert "cloudstack: docs: use local_action, not connection=local" (#17956)

docsite/rst/guide_cloudstack.rst

@@ -78,8 +78,7 @@ By passing the argument ``api_region`` with the CloudStack modules, the region w
 .. code-block:: yaml
 
     - name: ensure my ssh public key exists on Exoscale
-      local_action:
-        module: cs_sshkeypair
+      local_action: cs_sshkeypair
         name: my-ssh-key
         public_key: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
         api_region: exoscale
@@ -89,8 +88,7 @@ Or by looping over a regions list if you want to do the task in every region:
 .. code-block:: yaml
 
     - name: ensure my ssh public key exists in all CloudStack regions
-      local_action:
-        module: cs_sshkeypair
+      local_action: cs_sshkeypair
         name: my-ssh-key
         public_key: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
         api_region: "{{ item }}"
@@ -173,32 +171,28 @@ Now to the fun part. We create a playbook to create our infrastructure we call i
     ---
     - name: provision our VMs
       hosts: cloud-vm
+      connection: local
       tasks:
         - name: ensure VMs are created and running
-          local_action:
-            module: cs_instance
+          cs_instance:
             name: "{{ inventory_hostname_short }}"
             template: Linux Debian 7 64-bit 20GB Disk
             service_offering: "{{ cs_offering }}"
             state: running
 
-        - name: ensure static NATs
-          local_action:
-            module: cs_staticnat
-            vm: "{{ inventory_hostname_short }}"
-            ip_address: "{{ public_ip }}"
-          when: public_ip is defined
-
         - name: ensure firewall ports opened
-          local_action:
-            module: cs_firewall
+          cs_firewall:
             ip_address: "{{ public_ip }}"
             port: "{{ item.port }}"
             cidr: "{{ item.cidr | default('0.0.0.0/0') }}"
           with_items: cs_firewall
           when: public_ip is defined
 
-In the above play we defined 3 tasks and use the group ``cloud-vm`` as target to handle all VMs in the cloud but instead SSH to these VMs, we use ``local_action`` to execute the API calls locally from our workstation.
+        - name: ensure static NATs
+          cs_staticnat: vm="{{ inventory_hostname_short }}" ip_address="{{ public_ip }}"
+          when: public_ip is defined
+
+In the above play we defined 3 tasks and use the group ``cloud-vm`` as target to handle all VMs in the cloud but instead SSH to these VMs, we use ``connetion=local`` to execute the API calls locally from our workstation.
 
 In the first task, we ensure we have a running VM created with the Debian template. If the VM is already created but stopped, it would just start it. If you like to change the offering on an exisiting VM, you must add ``force: yes`` to the task, which would stop the VM, change the offering and start the VM again.
 
@@ -252,24 +246,22 @@ The playbook looks like the following:
     ---
     - name: cloud base setup
       hosts: localhost
+      connection: local
       tasks:
       - name: upload ssh public key
-          local_action:
-            module: cs_sshkeypair
+        cs_sshkeypair:
           name: defaultkey
           public_key: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
 
       - name: ensure security groups exist
-          local_action:
-            module: cs_securitygroup
+        cs_securitygroup:
           name: "{{ item }}"
         with_items:
           - default
           - web
 
       - name: add inbound SSH to security group default
-          local_action:
-            module: cs_securitygroup_rule
+        cs_securitygroup_rule:
           security_group: default
           start_port: "{{ item }}"
           end_port: "{{ item }}"
@@ -277,8 +269,7 @@ The playbook looks like the following:
           - 22
 
       - name: add inbound TCP rules to security group web
-          local_action:
-            module: cs_securitygroup_rule
+        cs_securitygroup_rule:
           security_group: web
           start_port: "{{ item }}"
           end_port: "{{ item }}"
@@ -288,32 +279,26 @@ The playbook looks like the following:
 
     - name: install VMs in the cloud
       hosts: cloud-vm
+      connection: local
       tasks:
       - name: create and run VMs on CloudStack
-          local_action:
-            module: cs_instance
+        cs_instance:
           name: "{{ inventory_hostname_short }}"
           template: Linux Debian 7 64-bit 20GB Disk
           service_offering: "{{ cs_offering }}"
           security_groups: "{{ cs_securitygroups }}"
           ssh_key: defaultkey
-            state: running
+          state: Running
         register: vm
 
       - name: show VM IP
-          debug:
-            msg: "VM {{ inventory_hostname }} {{ vm.default_ip }}"
+        debug: msg="VM {{ inventory_hostname }} {{ vm.default_ip }}"
 
       - name: assing IP to the inventory
-          set_fact:
-            ansible_ssh_host: "{{ vm.default_ip }}"
+        set_fact: ansible_ssh_host={{ vm.default_ip }}
 
       - name: waiting for SSH to come up
-          local_action:
-            module: wait_for
-            port: 22
-            host: "{{ vm.default_ip }}"
-            delay: 5
+        wait_for: port=22 host={{ vm.default_ip }} delay=5
 
 In the first play we setup the security groups, in the second play the VMs will created be assigned to these groups. Further you see, that we assign the public IP returned from the modules to the host inventory. This is needed as we do not know the IPs we will get in advance. In a next step you would configure the DNS servers with these IPs for accassing the VMs with their DNS name.