start with volume

Author: Cyclenerd

README.md

@@ -162,6 +162,7 @@ jobs:
 | `server_type`       |   | Name of the Server type this Server should be created with. | `cx22` (Intel x86, 2 vCPU, 4GB RAM, 40GB SSD) |
 | `server_wait`       |   | Wait up to `server_wait` retries (10 sec each) for the Hetzner Cloud Server to start. | `30` (5 min) |
 | `ssh_key`           |   | SSH key ID (integer) which should be injected into the Server at creation time. | `null` |
+| `volume`            |   | Volume ID which should be attached to the Server at the creation time. Volume must be in the same Location. | `null` |
 
 ## Outputs
 
@@ -291,6 +292,20 @@ hcloud network list --output "columns=ID,NAME,IP_RANGE,SERVERS"
 hcloud ssh-key list --output "columns=ID,NAME"
 ```
 
+**List Volumes:**
+
+```bash
+hcloud volume list --output "columns=ID,NAME,LOCATION"
+```
+
+**Create Volume:**
+
+To create a 10GB volume named `volume-test` in the Nuremberg DC Park 1 (`nbg1`) location, use the following command:
+
+```bash
+hcloud volume create --name "volume-test" --size "10" --location "nbg1"
+```
+
 ## Security
 
 > We recommend that you only use self-hosted runners with private repositories.

action.sh

@@ -226,6 +226,14 @@ if [[ "$MY_SSH_KEY" != "null" && ! "$MY_SSH_KEY" =~ ^[0-9]+$ ]]; then
 	exit_with_failure "The SSH key ID must be 'null' or an integer!"
 fi
 
+# Set the volume ID which should be attached to the instance at the creation time (default: null)
+# If INPUT_VOLUME is set, use its value; otherwise, use "null".
+MY_VOLUME=${INPUT_VOLUME:-"null"}
+# Check if MY_VOLUME is an integer
+if [[ "$MY_VOLUME" != "null" && ! "$MY_VOLUME" =~ ^[0-9]+$ ]]; then
+	exit_with_failure "The volume ID must be 'null' or an integer!"
+fi
+
 #
 # DELETE
 #
@@ -369,17 +377,23 @@ if [[ "$MY_PRIMARY_IPV6" != "null" ]]; then
 	jq ".public_net.ipv6 = $MY_PRIMARY_IPV6" < create-server-ipv6.json > create-server.json && \
 	echo "Primary IPv6 ID added to create-server.json."
 fi
+# Add network configuration to the create-server.json file if MY_NETWORK is not "null".
+if [[ "$MY_NETWORK" != "null" ]]; then
+	cp create-server.json create-server-network.json && \
+	jq ".networks += [$MY_NETWORK]" < create-server-network.json > create-server.json && \
+	echo "Network added to create-server.json."
+fi
 # Add SSH key configuration to the create-server.json file if MY_SSH_KEY is not "null".
 if [[ "$MY_SSH_KEY" != "null" ]]; then
 	cp create-server.json create-server-ssh.json && \
 	jq ".ssh_keys += [$MY_SSH_KEY]" < create-server-ssh.json > create-server.json && \
 	echo "SSH key added to create-server.json."
 fi
-# Add network configuration to the create-server.json file if MY_NETWORK is not "null".
-if [[ "$MY_NETWORK" != "null" ]]; then
-	cp create-server.json create-server-network.json && \
-	jq ".networks += [$MY_NETWORK]" < create-server-network.json > create-server.json && \
-	echo "Network added to create-server.json."
+# Add volume configuration to the create-server.json file if MY_VOLUME is not "null".
+if [[ "$MY_VOLUME" != "null" ]]; then
+	cp create-server.json create-server-volume.json && \
+	jq ".volumes += [$MY_VOLUME]" < create-server-volume.json > create-server.json && \
+	echo "Volume added to create-server.json."
 fi
 
 # Send a POST request to the Hetzner Cloud API to create a server.

action.yml

@@ -112,6 +112,11 @@ inputs:
       SSH key ID (integer) or name which should be injected into the Server at creation time.
     required: false
     default: 'null'
+  volume:
+    description: >-
+      Volume ID (integer) which should be attached to the Server at the creation time.
+    required: false
+    default: 'null'
 
 outputs:
   label:
@@ -154,3 +159,4 @@ runs:
         INPUT_SERVER_TYPE: ${{ inputs.server_type }}
         INPUT_SERVER_WAIT: ${{ inputs.server_wait }}
         INPUT_SSH_KEY: ${{ inputs.ssh_key }}
+        INPUT_VOLUME: ${{ inputs.volume }}

create-server.template.json

@@ -17,5 +17,6 @@
   },
   "start_after_create": true,
   "ssh_keys": [],
+  "volumes": [],
   "user_data": $cloud_init_yml,
 }