| aws-region | AWS Region | yes | — |
| application-name | Elastic Beanstalk Application Name | yes | — |
| environment-name | Elastic Beanstalk Environment Name | yes | — |
| version-label | Version label for deployment (defaults to git SHA) | no | — |
| deployment-package-path | Path to existing deployment package (auto-created if not specified) | no | — |
| solution-stack-name | Solution stack name (e.g., "64bit Amazon Linux 2023 v4.3.0 running Python 3.11", "64bit Amazon Linux 2023 v6.3.1 running Node.js 20"). Cannot be used with platform-arn. | no | — |
| platform-arn | Platform ARN for the environment (e.g., "arn:aws:elasticbeanstalk:us-east-1::platform/Python 3.11 running on 64bit Amazon Linux 2023/4.3.0"). Cannot be used with solution-stack-name. | no | — |
| create-environment-if-not-exists | Create environment if it does not exist | no | true |
| create-application-if-not-exists | Create application if it does not exist | no | true |
| wait-for-deployment | Wait for deployment to complete | no | true |
| wait-for-environment-recovery | Wait for environment health to recover after deployment | no | true |
| deployment-timeout | Maximum time to wait for each wait phase (seconds). If both wait-for-deployment and wait-for-environment-recovery are enabled, the total maximum wait is 2× this value. | no | 900 |
| max-retries | Maximum number of retries for failed operations | no | 2 |
| retry-delay | Initial delay between retries (seconds, uses exponential backoff) | no | 5 |
| use-existing-application-version-if-available | Reuse existing application version if it already exists | no | true |
| create-s3-bucket-if-not-exists | Create S3 bucket if it does not exist | no | true |
| s3-bucket-name | S3 bucket name for deployment packages (defaults to elasticbeanstalk-{region}-{accountId}) | no | — |
| cname-prefix | CNAME prefix for the environment URL (e.g. my-app → my-app.elasticbeanstalk.com). Must be 4–63 alphanumeric characters or hyphens. If omitted, AWS auto-assigns one. Only used when creating a new environment. | no | — |
| source-directory | Directory to package for deployment (defaults to workspace root). Useful for mono-repos where only a subdirectory should be deployed. | no | — |
| exclude-patterns | Comma-separated list of patterns to exclude from deployment package (e.g., "*.git*,*node_modules*,*.env*") | no | — |
| option-settings | Elastic Beanstalk option settings as JSON array. Required when creating a new environment - MUST include IAM settings: [{"Namespace":"aws:autoscaling:launchconfiguration","OptionName":"IamInstanceProfile","Value":"your-instance-profile"},{"Namespace":"aws:elasticbeanstalk:environment","OptionName":"ServiceRole","Value":"your-service-role"}] | no | — |