feat: initial

README.md

@@ -0,0 +1,47 @@
+# SKE Operations Action
+
+This action calls SKE cluster operations from your pipelines.
+
+## Usage
+
+To use this action in your workflow, reference it as a step.
+
+The action assumes that the STACKIT CLI and jq are installed.
+If you're using the [install-stackit-cli action](https://stackit-solutions.git.onstackit.cloud/actions/install-stackit-cli), then these applications will already be installed for you.
+
+You also require a STACKIT service account key.
+The key must be tied to a service account which has editor privileges on SKE resources.
+In the following example, the service account key is provided to the runner as a base64-encoded secret.
+
+```yaml
+- name: Install STACKIT CLI
+  uses: https://stackit-solutions.git.onstackit.cloud/actions/install-stackit-cli@v1
+- name: Set up STACKIT service account
+  env:
+    SA_KEY_B64: ${{ secrets.STACKIT_SERVICE_ACCOUNT_KEY_B64 }}
+  run: |
+    set -eo pipefail
+
+    TMP_SA_KEY_PATH="$(mktemp)"
+    echo "Writing STACKIT service account key to $TMP_SA_KEY_PATH"
+
+    echo "$SA_KEY_B64" | base64 -d > "$TMP_SA_KEY_PATH"
+    echo "STACKIT_SERVICE_ACCOUNT_KEY_PATH=$TMP_SA_KEY_PATH" >> "$GITHUB_ENV"
+- name: Hibernate cluster
+  uses: https://stackit-solutions.git.onstackit.cloud/actions/ske-operations@v1
+  with:
+    action: hibernate
+    region: eu01
+    project-id: 01234567-89ab-cdef-0123-456789abcdef
+    cluster-name: foo-cluster
+```
+
+## Inputs
+
+- `action` (Required): Operation to perform. Must be one of: `wake`, `hibernate`, `reconcile`, `maintenance`.
+- `region` (Required): Data center region of SKE cluster.
+- `project-id` (Required): STACKIT project ID.
+- `cluster-name` (Required): Name of SKE cluster.
+- `timeout-seconds` (Optional): Time in seconds after which target state check fails. Default is `900`.
+- `interval-seconds` (Optional): Time in seconds between target state checks. Default is `5`.
+- `wait` (Optional): Wait until target state of operation has been reached. Default is `true`.