How do I build an AWS Amplify app?

Overview

In this guide, we’ll walk through the steps to build an AWS Amplify app using infrastructure as code. AWS Amplify is a set of tools and services that enable developers to build scalable full-stack applications, powered by AWS. We’ll define the necessary resources, such as the Amplify App and Branch, configure them and set up deployment.

Detailed Steps to Create the AWS Amplify App

1. Define the AWS Amplify App: We’ll create an Amplify App that will serve as the main container for our application.
2. Configure a Branch: To manage the deployment of your application, you’ll define a branch (e.g., main).
3. Set up IAM Roles: We’ll configure the necessary IAM roles and policies to provide permissions needed by the Amplify app.
4. Output the Important Details: Finally, we’ll set up stack outputs to get the Amplify App ID and the Branch ARN, which are useful for deployment and monitoring.

Example Program

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.amplify.App("example", {
    name: "example-amplify-app",
    repository: "https://github.com/<your-repo>",
    oauthToken: "<your-oauth-token>",
    environmentVariables: {
        EXAMPLE_ENV_VAR: "example-value",
    },
});
const main = new aws.amplify.Branch("main", {
    appId: example.id,
    branchName: "main",
});
const amplifyServiceRole = new aws.iam.Role("amplify_service_role", {
    name: "amplify-service-role",
    assumeRolePolicy: JSON.stringify({
        Version: "2012-10-17",
        Statement: [{
            Action: "sts:AssumeRole",
            Effect: "Allow",
            Principal: {
                Service: "amplify.amazonaws.com",
            },
        }],
    }),
    managedPolicyArns: ["arn:aws:iam::aws:policy/AdministratorAccess"],
});
const attach = new aws.iam.RolePolicyAttachment("attach", {
    role: amplifyServiceRole.name,
    policyArn: "arn:aws:iam::aws:policy/AdministratorAccess",
});
export const amplifyAppId = example.id;
export const amplifyBranchArn = main.arn;

Key Points

• AWS Amplify App Configuration: We created the main Amplify App resource and configured it with a repository and environment variables.
• Branch Setup: Defined a branch to manage app deployment.
• IAM Role: Configured IAM roles and attached policies to provide necessary permissions.
• Outputs: Outputted key details like Amplify App ID and Branch ARN.

Conclusion

We successfully built an AWS Amplify app by defining necessary resources, configuring branches, and setting up IAM roles. These steps ensure a scalable and manageable setup for your Amplify application.