community / community.aws / 4.3.0 / module / aws_batch_compute_environment Manage AWS Batch Compute Environments | "added in version" 1.0.0 of community.aws" Authors: Jon Meran (@jonmer85)community.aws.aws_batch_compute_environment (4.3.0) — module
Install with ansible-galaxy collection install community.aws:==4.3.0
collections: - name: community.aws version: 4.3.0
This module allows the management of AWS Batch Compute Environments.
It is idempotent and supports "Check" mode.
Use module M(community.aws.aws_batch_compute_environment) to manage the compute environment, M(community.aws.aws_batch_job_queue) to manage job queues, M(community.aws.aws_batch_job_definition) to manage job definitions.
- name: My Batch Compute Environment community.aws.aws_batch_compute_environment: compute_environment_name: computeEnvironmentName state: present region: us-east-1 compute_environment_state: ENABLED type: MANAGED compute_resource_type: EC2 minv_cpus: 0 maxv_cpus: 2 desiredv_cpus: 1 instance_types: - optimal subnets: - my-subnet1 - my-subnet2 security_group_ids: - my-sg1 - my-sg2 instance_role: arn:aws:iam::<account>:instance-profile/<role> tags: tag1: value1 tag2: value2 service_role: arn:aws:iam::<account>:role/service-role/<role> register: aws_batch_compute_environment_action
- name: show results ansible.builtin.debug: var: aws_batch_compute_environment_action
tags: description: - Key-value pair tags to be applied to resources that are launched in the compute environment. type: dict type: choices: - MANAGED - UNMANAGED description: - The type of the compute environment. required: true type: str state: choices: - present - absent default: present description: - Describes the desired state. type: str region: aliases: - aws_region - ec2_region description: - The AWS region to use. If not specified then the value of the AWS_REGION or EC2_REGION environment variable, if any, is used. See U(http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region) type: str ec2_url: aliases: - aws_endpoint_url - endpoint_url description: - Url to use to connect to EC2 or your Eucalyptus cloud (by default the module will use EC2 endpoints). Ignored for modules where region is required. Must be specified for all other modules if region is not used. If not set then the value of the EC2_URL environment variable, if any, is used. type: str profile: aliases: - aws_profile description: - Uses a boto profile. Only works with boto >= 2.24.0. - Using I(profile) will override I(aws_access_key), I(aws_secret_key) and I(security_token) and support for passing them at the same time as I(profile) has been deprecated. - I(aws_access_key), I(aws_secret_key) and I(security_token) will be made mutually exclusive with I(profile) after 2022-06-01. type: str subnets: description: - The VPC subnets into which the compute resources are launched. elements: str required: true type: list image_id: description: - The Amazon Machine Image (AMI) ID used for instances launched in the compute environment. type: str maxv_cpus: description: - The maximum number of EC2 vCPUs that an environment can reach. required: true type: int minv_cpus: description: - The minimum number of EC2 vCPUs that an environment should maintain. required: true type: int aws_config: description: - A dictionary to modify the botocore configuration. - Parameters can be found at U(https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config). - Only the 'user_agent' key is used for boto modules. See U(http://boto.cloudhackers.com/en/latest/boto_config_tut.html#boto) for more boto configuration. type: dict ec2_key_pair: description: - The EC2 key pair that is used for instances launched in the compute environment. type: str service_role: description: - The full Amazon Resource Name (ARN) of the IAM role that allows AWS Batch to make calls to other AWS services on your behalf. required: true type: str aws_ca_bundle: description: - The location of a CA Bundle to use when validating SSL certificates. - Only used for boto3 based modules. - 'Note: The CA Bundle is read ''module'' side and may need to be explicitly copied from the controller if not run locally.' type: path desiredv_cpus: description: - The desired number of EC2 vCPUS in the compute environment. type: int instance_role: description: - The Amazon ECS instance role applied to Amazon EC2 instances in a compute environment. required: true type: str aws_access_key: aliases: - ec2_access_key - access_key description: - AWS access key. If not set then the value of the AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY or EC2_ACCESS_KEY environment variable is used. - If I(profile) is set this parameter is ignored. - Passing the I(aws_access_key) and I(profile) options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01. type: str aws_secret_key: aliases: - ec2_secret_key - secret_key description: - AWS secret key. If not set then the value of the AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY, or EC2_SECRET_KEY environment variable is used. - If I(profile) is set this parameter is ignored. - Passing the I(aws_secret_key) and I(profile) options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01. type: str bid_percentage: description: - The minimum percentage that a Spot Instance price must be when compared with the On-Demand price for that instance type before instances are launched. - For example, if your bid percentage is 20%, then the Spot price must be below 20% of the current On-Demand price for that EC2 instance. type: int instance_types: description: - The instance types that may be launched. elements: str required: true type: list security_token: aliases: - aws_security_token - access_token description: - AWS STS security token. If not set then the value of the AWS_SECURITY_TOKEN or EC2_SECURITY_TOKEN environment variable is used. - If I(profile) is set this parameter is ignored. - Passing the I(security_token) and I(profile) options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01. type: str validate_certs: default: true description: - When set to "no", SSL certificates will not be validated for boto versions >= 2.6.0. type: bool security_group_ids: description: - The EC2 security groups that are associated with instances launched in the compute environment. elements: str required: true type: list spot_iam_fleet_role: description: - The Amazon Resource Name (ARN) of the Amazon EC2 Spot Fleet IAM role applied to a SPOT compute environment. type: str compute_resource_type: choices: - EC2 - SPOT description: - The type of compute resource. required: true type: str compute_environment_name: description: - The name for your compute environment. - Up to 128 letters (uppercase and lowercase), numbers, and underscores are allowed. required: true type: str compute_environment_state: choices: - ENABLED - DISABLED default: ENABLED description: - The state of the compute environment. - If the state is C(ENABLED), then the compute environment accepts jobs from a queue and can scale out automatically based on queues. type: str debug_botocore_endpoint_logs: default: 'no' description: - Use a botocore.endpoint logger to parse the unique (rather than total) "resource:action" API calls made during a task, outputing the set to the resource_actions key in the task results. Use the aws_resource_action callback to output to total list made during a playbook. The ANSIBLE_DEBUG_BOTOCORE_LOGS environment variable may also be used. type: bool
output: description: returns what action was taken, whether something was changed, invocation and response returned: always sample: batch_compute_environment_action: none changed: false invocation: module_args: aws_access_key: null aws_secret_key: null bid_percentage: null compute_environment_name: <name> compute_environment_state: ENABLED compute_resource_type: EC2 desiredv_cpus: 0 ec2_key_pair: null ec2_url: null image_id: null instance_role: arn:aws:iam::... instance_types: - optimal maxv_cpus: 8 minv_cpus: 0 profile: null region: us-east-1 security_group_ids: - '*******' security_token: null service_role: arn:aws:iam::.... spot_iam_fleet_role: null state: present subnets: - '******' tags: Environment: <name> Name: <name> type: MANAGED validate_certs: true response: computeEnvironmentArn: arn:aws:batch:.... computeEnvironmentName: <name> computeResources: desiredvCpus: 0 instanceRole: arn:aws:iam::... instanceTypes: - optimal maxvCpus: 8 minvCpus: 0 securityGroupIds: - '******' subnets: - '*******' tags: Environment: <name> Name: <name> type: EC2 ecsClusterArn: arn:aws:ecs:..... serviceRole: arn:aws:iam::... state: ENABLED status: VALID statusReason: ComputeEnvironment Healthy type: MANAGED type: dict