Service

Source: src/AWS/AppRunner/Service.ts

An AWS App Runner service — the zero-infrastructure way to run a container behind an HTTPS endpoint: App Runner provisions, load-balances, scales, and patches the fleet for you. Service creation and deletion are asynchronous and take several minutes; the provider waits (bounded) for operations to settle.

Service is a Platform: alongside the low-level container-image form (imageRepository), it supports Effect-native implementations — an inline Effect HTTP program that Alchemy bundles, containerizes, pushes to a managed ECR repository, and deploys, provisioning the instance and ECR access roles automatically. Capability bindings (e.g. DynamoDB GetItem) attach IAM policy statements to the managed instance role.

Creating a Service

Public ECR Image

const service = yield* AppRunner.Service("Hello", {
  imageRepository: {
    imageIdentifier: "public.ecr.aws/aws-containers/hello-app-runner:latest",
    imageRepositoryType: "ECR_PUBLIC",
    port: "8000",
  },
  instanceConfiguration: { cpu: "256", memory: "512" },
});
// service.serviceUrl -> "xxxxxxxx.us-west-2.awsapprunner.com"

Private ECR Image with Access Role

const service = yield* AppRunner.Service("Api", {
  imageRepository: {
    imageIdentifier: `${repository.repositoryUri}:latest`,
    imageRepositoryType: "ECR",
    port: "8080",
    runtimeEnvironmentVariables: { NODE_ENV: "production" },
  },
  accessRoleArn: accessRole.roleArn,
  autoDeploymentsEnabled: true,
});

Effect-Native Services

export default class Api extends AppRunner.Service<Api>()(
  "Api",
  {
    main: import.meta.url,
    port: 3000,
    instanceConfiguration: { cpu: "256", memory: "512" },
  },
  Effect.gen(function* () {
    return {
      fetch: Effect.gen(function* () {
        const request = yield* HttpServerRequest;
        return HttpServerResponse.text("hello from app runner");
      }),
    };
  }),
) {}

Scaling and Networking

const service = yield* AppRunner.Service("Api", {
  imageRepository: {
    imageIdentifier: "public.ecr.aws/aws-containers/hello-app-runner:latest",
    imageRepositoryType: "ECR_PUBLIC",
    port: "8000",
  },
  autoScalingConfigurationArn: scaling.autoScalingConfigurationArn,
  networkConfiguration: {
    egressType: "VPC",
    vpcConnectorArn: connector.vpcConnectorArn,
  },
});