feat: allow a workflow to specify an environment name

Author: hussainweb

README.md

@@ -24,6 +24,10 @@ The PHP version to use. This is directly passed to [`shivammathur/setup-php`](ht
 
 An option to force push changes to the project repository on Platform.sh. Use with caution as force push overrides your commit history.
 
+### `environment-name`
+
+The name of the platform.sh instance on which to act. Default: The current branch name.
+
 ## Outputs
 
 No outputs.

action.yml

@@ -17,6 +17,9 @@ inputs:
   force-push:
     description: 'Force push to Platform.sh'
     required: false
+  environment-name:
+    description: 'Name of the platform.sh instance'
+    required: false
 runs:
   using: "composite"
   steps:
@@ -36,6 +39,7 @@ runs:
         PLATFORM_PROJECT_ID: ${{ inputs.project-id }}
         PLATFORMSH_CLI_TOKEN: ${{ inputs.cli-token }}
         FORCE_PUSH: ${{ inputs.force-push }}
+        ENVIRONMENT_NAME: ${{ inputs.environment-name }}
 branding:
   icon: upload-cloud
   color: orange

deploy.sh

@@ -11,7 +11,8 @@ mkdir -p ~/.ssh && chmod 0700 ~/.ssh
 cat ${GITHUB_ACTION_PATH}/known_hosts >> ~/.ssh/known_hosts
 
 platform project:set-remote ${PLATFORM_PROJECT_ID}
-PLATFORM_OPTS="-vv --activate --target ${GITHUB_REF_NAME}"
+[[ "$ENVIRONMENT_NAME" == "" ]] && ENVIRONMENT_NAME="$GITHUB_REF_NAME"
+PLATFORM_OPTS="-vv --activate --target $ENVIRONMENT_NAME"
 if [[ -n "$FORCE_PUSH" ]]; then
   PLATFORM_OPTS="$PLATFORM_OPTS --force"
 fi