View a markdown version of this page

Prerequisites for using Amazon MWAA Serverless - Amazon Managed Workflows for Apache Airflow Serverless

Prerequisites for using Amazon MWAA Serverless

Learn about the prerequisites you need before using Amazon MWAA Serverless. These include account setup and permissions management. You must have an AWS account before completing these tasks.

Sign up for an AWS account

To get started with AWS, you need an AWS account. For information about creating an AWS account, see Getting started with an AWS account in the AWS Account Management Reference Guide.

Grant IAM permissions

We recommend that you use finer-grained policies. For policy setup, refer to How Amazon MWAA Serverless works with IAM. To learn more about access management, refer to Access management for AWS resources in the IAM User Guide. For example, you can use policy similar to following.

JSON
{ "Version":"2012-10-17", "Statement": [ { "Sid": "MWAAServerlessFullAccess", "Effect": "Allow", "Action": [ "airflow-serverless:*" ], "Resource": [ "*" ] }, { "Sid": "MWAAServerlessSLRCreation", "Effect": "Allow", "Action": [ "iam:CreateServiceLinkedRole" ], "Resource": [ "*" ] }, { "Sid": "MWAAServerlessServicePassroleAccess", "Effect": "Allow", "Action": [ "iam:PassRole" ], "Resource": [ "*" ] }, { "Sid": "MWAAServerlessServiceS3ReadAccess", "Effect": "Allow", "Action": [ "s3:GetObject", 's3:GetObjectVersion' ], "Resource": [ "*" ] }, { "Sid": "MWAAServerlessServiceCWLogsAccess", "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:DescribeLogGroups" ], "Resource": [ "*" ] }, { "Sid": "MWAAServerlessServiceKMSAccess", "Effect": "Allow", "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:GenerateDataKey", "kms:DescribeKey" ], "Resource": [ "*" ] } ] }

To provide access, add permissions to your users, groups, or roles:

Grant programmatic access

Users need programmatic access if they want to interact with AWS outside of the AWS Management Console. The way to grant programmatic access depends on the type of user that's accessing AWS.

To grant users programmatic access, choose one of the following options.

Which user needs programmatic access? To By
IAM (Recommended) Use console credentials as temporary credentials to sign programmatic requests to the AWS CLI, AWS SDKs, or AWS APIs.

Following the instructions for the interface that you want to use.

Workforce identity

(Users managed in IAM Identity Center)

Use temporary credentials to sign programmatic requests to the AWS CLI, AWS SDKs, or AWS APIs.

Following the instructions for the interface that you want to use.

IAM Use temporary credentials to sign programmatic requests to the AWS CLI, AWS SDKs, or AWS APIs. Following the instructions in Using temporary credentials with AWS resources in the IAM User Guide.
IAM

(Not recommended)

Use long-term credentials to sign programmatic requests to the AWS CLI, AWS SDKs, or AWS APIs.

Following the instructions for the interface that you want to use.

Install and configure the AWS CLI

If you want to use Amazon MWAA Serverless APIs with the AWS Command Line Interface (AWS CLI), use the following instructions to install the latest version.

Tip

If you prefer to use Amazon MWAA Serverless with SDKs, you can access AWS builder tools in the Builder Center. Tools are listed by programming language.

To set up the AWS CLI
  1. To install the latest version of the AWS CLI for macOS, Linux, or Windows, refer to Installing or updating the latest version of the AWS CLI.

  2. To configure the AWS CLI and secure setup of your access to AWS services, including Amazon MWAA Serverless, refer to Quick configuration with aws configure.

  3. To verify the setup, enter the following command at the command prompt.

    CLI
    aws mwaa-serverless help

    AWS CLI commands use the default AWS Region from your configuration, unless you set it with a parameter or a profile. To set your AWS Region with a parameter, you can add the --region parameter to each command.

    To set your AWS Region with a profile, first add a named profile in the ~/.aws/config file or the %UserProfile%/.aws/config file (for Microsoft Windows). Follow the steps in Named profiles for the AWS CLI. Next, set your AWS Region and other settings with a command similar to the one in the following example.

    CLI
    [profile mwaa-serverless] aws_access_key_id = ACCESS-KEY-ID-OF-IAM-USER aws_secret_access_key = SECRET-ACCESS-KEY-ID-OF-IAM-USER region = us-east-1 output = text