Merging upstream version 9.4.0+dfsg.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

5 files changed, 181 insertions, 0 deletions

diff --git a/ansible_collections/hetzner/hcloud/examples/inventory.hcloud.yml b/ansible_collections/hetzner/hcloud/examples/inventory.hcloud.yml
new file mode 100644
index 000000000..6a67e2836
--- /dev/null
+++ b/ansible_collections/hetzner/hcloud/examples/inventory.hcloud.yml
@@ -0,0 +1,7 @@
+# You can list the hosts using:
+# ansible-inventory  --list -i examples/inventory.hcloud.yml --extra-vars=network_name=my-network
+
+plugin: hetzner.hcloud.hcloud
+
+network: "{{ network_name }}"
+status: [running]
diff --git a/ansible_collections/hetzner/hcloud/examples/server-with-firewall.yml b/ansible_collections/hetzner/hcloud/examples/server-with-firewall.yml
new file mode 100644
index 000000000..0e5709676
--- /dev/null
+++ b/ansible_collections/hetzner/hcloud/examples/server-with-firewall.yml
@@ -0,0 +1,62 @@
+---
+- name: Demonstrate creating servers with a firewall
+  hosts: localhost
+  connection: local
+
+  vars:
+    servers:
+      - name: my-server1
+      - name: my-server2
+
+  tasks:
+    - name: Create firewall
+      hetzner.hcloud.firewall:
+        name: my-firewall
+        rules:
+          - description: allow icmp from everywhere
+            direction: in
+            protocol: icmp
+            source_ips:
+              - 0.0.0.0/0
+              - ::/0
+          - description: allow ssh from everywhere
+            direction: in
+            protocol: tcp
+            port: 22
+            source_ips:
+              - 0.0.0.0/0
+              - ::/0
+        state: present
+
+    - name: Create servers
+      hetzner.hcloud.server:
+        name: "{{ item.name }}"
+        server_type: cx11
+        image: debian-12
+        labels:
+          kind: runners
+        state: started
+      loop: "{{ servers }}"
+
+    - name: Apply firewall to resources using label selectors
+      hetzner.hcloud.firewall_resource:
+        firewall: my-firewall
+        label_selectors: [kind=runners]
+        state: present
+
+    - name: Apply firewall to individual servers
+      hetzner.hcloud.firewall_resource:
+        firewall: my-firewall
+        servers: "{{ servers | map(attribute='name') }}"
+        state: present
+
+    - name: Delete firewall
+      hetzner.hcloud.firewall:
+        name: my-firewall
+        state: absent
+
+    - name: Delete servers
+      hetzner.hcloud.server:
+        name: "{{ item.name }}"
+        state: absent
+      loop: "{{ servers }}"
diff --git a/ansible_collections/hetzner/hcloud/examples/server-with-private-ip-only.yml b/ansible_collections/hetzner/hcloud/examples/server-with-private-ip-only.yml
new file mode 100644
index 000000000..67cf47e51
--- /dev/null
+++ b/ansible_collections/hetzner/hcloud/examples/server-with-private-ip-only.yml
@@ -0,0 +1,50 @@
+---
+- name: Demonstrate creating a server that only has a private ip
+  hosts: localhost
+  connection: local
+
+  vars:
+    servers:
+      - name: my-server1
+        private_ip: 10.0.0.2
+      - name: my-server2
+        private_ip: 10.0.0.3
+
+  tasks:
+    - name: Create a network
+      hetzner.hcloud.network:
+        name: my-network
+        ip_range: 10.0.0.0/8
+        state: present
+
+    - name: Create a subnetwork
+      hetzner.hcloud.subnetwork:
+        network: my-network
+        ip_range: 10.0.0.0/16
+        network_zone: eu-central
+        type: cloud
+        state: present
+
+    - name: Create servers without public IPs
+      hetzner.hcloud.server:
+        name: "{{ item.name }}"
+        server_type: cx11
+        image: debian-12
+        enable_ipv4: false
+        enable_ipv6: false
+        state: stopped # A server without networking cannot be started!
+      loop: "{{ servers }}"
+
+    - name: Attach private IP to servers
+      hetzner.hcloud.server_network:
+        network: my-network
+        server: "{{ item.name }}"
+        ip: "{{ item.private_ip }}"
+        state: present
+      loop: "{{ servers }}"
+
+    - name: Start servers
+      hetzner.hcloud.server:
+        name: "{{ item.name }}"
+        state: started
+      loop: "{{ servers }}"
diff --git a/ansible_collections/hetzner/hcloud/examples/use-module-defaults-group.yml b/ansible_collections/hetzner/hcloud/examples/use-module-defaults-group.yml
new file mode 100644
index 000000000..f3de9adac
--- /dev/null
+++ b/ansible_collections/hetzner/hcloud/examples/use-module-defaults-group.yml
@@ -0,0 +1,27 @@
+---
+- name: Demonstrate the usage of the 'hetzner.hcloud.all' module_defaults group
+  hosts: localhost
+  connection: local
+
+  module_defaults:
+    group/hetzner.hcloud.all:
+      api_token: LRK9DAWQ1ZAEFSrCNEEzLCUwhYX1U3g7wMg4dTlkkDC96fyDuyJ39nVbVjCKSDfj
+
+  tasks:
+    - name: Create a volume
+      hetzner.hcloud.volume:
+        name: my-volume
+        location: fsn1
+        size: 100
+        state: present
+      register: volume
+
+    - name: Create a server
+      hetzner.hcloud.server:
+        name: my-server
+        server_type: cx11
+        image: debian-12
+        location: fsn1
+        volumes:
+          - "{{ volume.hcloud_volume.id }}"
+        state: present
diff --git a/ansible_collections/hetzner/hcloud/examples/use-refresh-inventory.yml b/ansible_collections/hetzner/hcloud/examples/use-refresh-inventory.yml
new file mode 100644
index 000000000..fd4c351b6
--- /dev/null
+++ b/ansible_collections/hetzner/hcloud/examples/use-refresh-inventory.yml
@@ -0,0 +1,35 @@
+---
+- name: Demonstrate the usage of 'refresh_inventory'
+  hosts: localhost
+  connection: local
+
+  tasks:
+    - name: Print hostvars
+      ansible.builtin.debug:
+        var: hostvars
+
+    - name: Create new server
+      hetzner.hcloud.server:
+        name: my-server
+        server_type: cx11
+        image: debian-12
+
+    - name: Refresh inventory
+      ansible.builtin.meta: refresh_inventory
+
+    - name: Run tests
+      block:
+        - name: Print updated inventory
+          ansible.builtin.debug:
+            var: hostvars
+
+        - name: Verify hostvars is not empty
+          ansible.builtin.assert:
+            that:
+              - hostvars != {}
+
+      always:
+        - name: Cleanup server
+          hetzner.hcloud.server:
+            name: my-server
+            state: absent