Spring Boot アプリケーションをお手軽に本番運用

import * as cdk from 'aws-cdk-lib';
import { StackProps } from 'aws-cdk-lib';
import { Construct } from 'constructs';
import * as ec2 from 'aws-cdk-lib/aws-ec2';
import * as elasticache from 'aws-cdk-lib/aws-elasticache';
import * as ssm from 'aws-cdk-lib/aws-ssm';

/**
* ElastiCache へ接続するための情報
*/
export type CacheConnection = {
  /** Redis に付与された SecurityGroup ID */
  readonly securityGroupId: string;
  /** Redis のホスト名 */
  // readonly host: string;
  // 文字列から、 Parameter Store にデータを変更
  readonly host: ssm.StringParameter;
  /** Redis のポート */
  // 文字列から、 Parameter Store にデータを変更
  // readonly port: string;
  readonly port: ssm.StringParameter;
}

/**
* Redis などのインフラを構築するスタック
*/
export class InfraStack extends cdk.Stack {

  /** 構築した VPC */
  readonly vpc: ec2.IVpc;
  /** 構築した Redis への接続情報 */
  readonly cacheConnection: CacheConnection;

  constructor(scope: Construct, id: string, props?: StackProps) {
    super(scope, id, props);

    // VPC を構築
    this.vpc = new ec2.Vpc(this, 'Vpc', {
      natGateways: 1
    });

    // Redis を構築し、そこに接続するための情報を保存する
    this.cacheConnection = this.cache();
  }

  /**
   * Redis を構築
   * @returns 構築した Redis へ接続するための情報
   */
  private cache(): CacheConnection {
    // Redis に付与されるセキュリティグループ
    const cacheSecurityGroup = new ec2.SecurityGroup(this, "CacheSecurityGroup", { vpc: this.vpc });

    // Redis を構築する VPC のサブネット
    const subnetGroup = new elasticache.CfnSubnetGroup(this, "CacheSubnetGroup", {
      subnetIds: this.vpc.selectSubnets({ subnetType: ec2.SubnetType.PRIVATE_WITH_EGRESS }).subnetIds,
      description: "Group of subnets to place Cache into",
    });

    // Redis 構築
    const cacheCluster = new elasticache.CfnCacheCluster(this, "CacheCluster", {
      engine: "redis",
      cacheNodeType: "cache.t3.micro",
      numCacheNodes: 1,
      cacheSubnetGroupName: subnetGroup.ref,
      vpcSecurityGroupIds: [cacheSecurityGroup.securityGroupId],
    });
    
    // Redis へ接続するための情報を SSM Parameter Store に登録
    const cacheHostParameter = new ssm.StringParameter(this, "CacheHostParameter", {
      stringValue: cacheCluster.attrRedisEndpointAddress,
    });
    const cachePortParameter = new ssm.StringParameter(this, "CachePortParameter", {
      stringValue: cacheCluster.attrRedisEndpointPort,
    });
    
    // Redis へ接続するための情報を返り値にする
    return {
      securityGroupId: cacheSecurityGroup.securityGroupId,
      // host: cacheCluster.attrRedisEndpointAddress,
      // 接続情報を文字列から Paramete Store に変更
      host: cacheHostParameter,
      // port: cacheCluster.attrRedisEndpointPort,
      // 接続情報を文字列から Paramete Store に変更
      port: cachePortParameter,
    }
  }
}

import * as cdk from 'aws-cdk-lib';
import { StackProps } from 'aws-cdk-lib';
import { Construct } from 'constructs';
import * as ec2 from 'aws-cdk-lib/aws-ec2';
import * as apprunner from 'aws-cdk-lib/aws-apprunner';
import { CacheConnection } from './infra-stack';

export class ServiceStack extends cdk.Stack {
  constructor(scope: Construct, id: string, vpc: ec2.IVpc, cacheConnection: CacheConnection, props?: StackProps) {
    super(scope, id, props);

    // VPC での App Runner サービスのセキュリティグループ
    const vpcConnectionSecurityGroup = new ec2.SecurityGroup(this, "SecurityGroup", { vpc });

    // App Runner サービスが、ElastiCache へ接続できるようセキュリティグループを設定
    const cacheSecurityGroup = ec2.SecurityGroup.fromSecurityGroupId(
      this, "CacheSecurityGroup", cacheConnection.securityGroupId, {
    });
    cacheSecurityGroup.addIngressRule(
      vpcConnectionSecurityGroup, ec2.Port.tcp(6379), "Ingress to the cache");

    // App Runner サービスと VPC の接続 (VPC Connector) を作成
    const connector = new apprunner.CfnVpcConnector(this, 'VpcConnector', {
      subnets: vpc.selectSubnets({ subnetType: ec2.SubnetType.PRIVATE_WITH_EGRESS }).subnetIds,
      securityGroups: [ vpcConnectionSecurityGroup.securityGroupId ],
    });
    // SSM Parameter Store に保存された Redis の接続情報を取得できるよう、IAM Role を App Runner サービスに追加
    const instanceRole = new iam.Role(this, 'InstanceRole', {
      // App Runner サービスにより使用されるという設定
      assumedBy: new iam.ServicePrincipal('tasks.apprunner.amazonaws.com'),
      
      inlinePolicies: {
        ssmParameter: new iam.PolicyDocument({
          statements: [
            new iam.PolicyStatement({
              // Parameter Store からのパラメーター取得を許可する設定
              effect: iam.Effect.ALLOW,
              actions: [ "ssm:GetParameters" ],
              resources: [
                cacheConnection.host.parameterArn,
                cacheConnection.port.parameterArn,
              ],
            }),
          ],
        }),
      },
    });
    // App Runner サービスを作成
    const service = new apprunner.CfnService(this, 'Service', {
      sourceConfiguration: {
        authenticationConfiguration: {
          // ソースコード取得用の CodeStar Connection ARN を設定
          connectionArn: this.node.tryGetContext('connectionArn'),
        },
        codeRepository: {
          // ソースコードのリポジトリ URL やブランチを設定
          repositoryUrl: this.node.tryGetContext('repositoryUrl'),
          sourceCodeVersion: {
            type: "BRANCH",
            value: "main",
          },
          codeConfiguration: {
            configurationSource: "API",
            codeConfigurationValues: {
              // Java のマネージドランタイムを設定
              runtime: "CORRETTO_11",
              // アプリケーションのビルドコマンド
              buildCommand: "./gradlew bootJar && cp build/libs/*.jar ./",
              // アプリケーションの実行コマンド
              startCommand: "java -jar ./expt-apprunner-springboot.jar",
              // アプリケーションに設定する環境変数
              // runtimeEnvironmentVariables: [
              //  {
              //     name: "CACHE_HOST",
              //     // InfraStack から渡された ElastiCache のホスト名
              //     value: cacheConnection.host,
              //   },
              //   {
              //     name: "CACHE_PORT",
              //     // InfraStack から渡された ElastiCache のポート番号
              //     value: cacheConnection.port,
              //   },
              // ],
              
              // 環境変数を Parameter Store, Secretes Manager から取得する場合は
              // runtimeEnvironmentSecretsを使用して、取得する値のARNを設定
              runtimeEnvironmentSecrets: [
                {
                  name: "CACHE_HOST",
                  value: cacheConnection.host.parameterArn,
                },
                {
                  name: "CACHE_PORT",
                  value: cacheConnection.port.parameterArn,
                },
              ],
            }
          },
        },
      },
      
      // この App Runner サービスに IAM Role をセットする
      instanceConfiguration: {
        instanceRoleArn: instanceRole.roleArn,
      },
      networkConfiguration: {
        egressConfiguration: {
          egressType: "VPC",
          vpcConnectorArn: connector.attrVpcConnectorArn,
        },
      },
    });
    new cdk.CfnOutput(this, 'AppRunnerServiceURL', {
      value: service.attrServiceUrl,
    });
  }
}

    // SSM Parameter Store に保存された Redis の接続情報を取得できるよう、IAM Role を App Runner サービスに追加
    const instanceRole = new iam.Role(this, 'InstanceRole', {
      // App Runner サービスにより使用されるという設定
      assumedBy: new iam.ServicePrincipal('tasks.apprunner.amazonaws.com'),
      
      inlinePolicies: {
        ssmParameter: new iam.PolicyDocument({
          statements: [
            new iam.PolicyStatement({
              // Parameter Store からのパラメーター取得を許可する設定
              effect: iam.Effect.ALLOW,
              actions: [ "ssm:GetParameters" ],
              resources: [
                cacheConnection.host.parameterArn,
                cacheConnection.port.parameterArn,
              ],
            }),
          ],
        }),
      },
    });
    
...
    // App Runner サービスを作成
    const service = new apprunner.CfnService(this, 'Service', {
    ...
      // この App Runner サービスに IAM Role をセットする
      instanceConfiguration: {
        instanceRoleArn: instanceRole.roleArn,
      },

    // App Runner サービスを作成
    const service = new apprunner.CfnService(this, 'Service', {
      sourceConfiguration: {
      ...
        codeRepository: {
        ...
          codeConfiguration: {
          ...
            codeConfigurationValues: {
              ...              
              // 環境変数を Parameter Store, Secretes Manager から取得する場合は
              // runtimeEnvironmentSecretsを使用して、取得する値のARNを設定
              runtimeEnvironmentSecrets: [
                {
                  name: "CACHE_HOST",
                  value: cacheConnection.host.parameterArn,
                },
                {
                  name: "CACHE_PORT",
                  value: cacheConnection.port.parameterArn,
                },
              ],

# infra-stack.ts で定義している設定 (cacheConnection.host, cacheConnection.port) を使用しているため、
# 一度 ServiceStack を削除しないと infra-stack.ts の設定を反映できない
npx cdk destroy ServiceStack
npx cdk deploy ServiceStack