AWS 배포하기 - A2 Resources

AWS에 도커 이미지를 배포할 수 있는 플랫폼에는 AWS EC2, AWS App Runner, AWS Lightsail, AWS EKS 등 다양한 방법이 있습니다. 이 중 가장 간단한 AWS ECS를 활용하여 배포하는 방법을 설명합니다.

도커 이미지 ECR에 등록하기

AWS에서 도커 이미지를 활용하기 위해서는 Elastic Container Registry(이하 ECR)에 이미지를 등록해야 합니다. 이미지 등록과 관련된 자세한 내용은 AWS 공식 문서를 참고하여 리포지토리 생성부터 도커 이미지 푸시까지 진행하십시오.

모든 과정을 마치면 ECR 리포지토리에서 다음과 같은 화면을 볼 수 있습니다.

앞으로는 URI 컬럼에 있는 값을 활용하여 이미지를 배포합니다.

AWS ECS 설정하기

1. 클러스터 생성하기

AWS Elastic Container Service(ECS)를 사용하려면 먼저 클러스터를 생성해야 합니다. ECS의 Clusters > Create Cluster 메뉴에서 아래와 같은 화면을 볼 수 있습니다.

Cluster name에 적절한 이름을 입력합니다.
Volume 유지를 위해 Amazon EC2 instances를 선택하고, 인스턴스 유형은 c5.2xlarge (8 vCPU, 16GB RAM) 이상을 권장합니다.
Desired capacity는 Minimum: 1, Maximum: 1로 설정합니다.
클러스터를 생성합니다.

2. 태스크 정의하기

이미지를 사용하려면 태스크를 먼저 정의해야 합니다. ECS의 Task definition > Create new task definition 메뉴에서 다음을 설정합니다.

Task definition configuration
- 적절한 태스크 이름을 입력합니다.
Infrastructure requirements
- Launch type은 AWS EC2 Instances로 선택합니다.
- Operating system/Architecture는 Linux/X86_64로 선택합니다.
- Task size는 빈칸으로 비워둡니다.

Container
- 적절한 컨테이너 이름과 ECR에 등록된 이미지 URI를 입력합니다.
- 서비스 포트로 8000번 포트를 엽니다.
- 태스크에 포함된 컨테이너에 모든 리소스를 할당합니다.
- Logging에서 Use log collection 옵션을 활성화합니다.
- CPU/GPU 설정은 빈칸으로 둡니다.
- 메모리 제한은 다음과 같이 설정합니다.
  - EC2 인스턴스 메모리 크기가 N GB(예: 16GB)일 경우, hard limit은 N, soft limit은 N/2 - 1로 설정합니다.
  - soft limit을 이렇게 설정하는 이유는 롤링 배포 시 두 개의 태스크가 일시적으로 실행되기 때문입니다.

Volume
- A2의 데이터는 /data에 저장됩니다. 데이터를 유지하려면 적당한 크기의 스토리지를 정의하고 해당 경로에 마운트합니다.
- AWS EBS를 사용해 데이터를 유지하려면 Configuration Type을 Configure at task definition creation으로 지정하고, 볼륨 타입은 bind mount로 선택합니다.
- Source path에 /data를 입력합니다.

3. 보안 그룹 생성하기

이제 각 마이크로서비스 간의 인바운드 규칙을 설정하기 위해 두 개의 보안 그룹을 생성합니다. 하나는 태스크용 보안 그룹이고, 다른 하나는 로드 밸런서용입니다.

AWS 콘솔에서 상단의 검색창에 ‘security group’을 입력하면 보안 그룹 페이지로 이동할 수 있습니다.

우측 상단의 ‘Create security group’ 버튼을 클릭하여 설정을 시작합니다.

로드 밸런서용 보안 그룹

보안 그룹 이름과 인바운드 규칙을 설정합니다.
- 예시: security-lb
- 포트 8000 에 대한 인바운드 규칙을 추가합니다.
  - 예시에서는 Source를 Anywhere로 설정했지만, 보안을 위해 특정 IP를 지정하는 것이 좋습니다.

태스크용 보안 그룹

8000에 대해 인바운드 규칙을 추가하고, Source는 로드 밸런서의 보안 그룹을 지정합니다.

4. 타겟 그룹 생성하기

로드 밸런서가 요청을 전달할 타겟 그룹을 생성합니다. Target group을 검색한 뒤 페이지로 이동합니다.

태스크용 타겟 그룹

포트8000에 대한 타겟 그룹을 생성합니다.
타겟 타입은 IP addresses로 선택하고, 포트는 8000으로 설정합니다.

Health check path는 /api/health로 입력합니다.
Next를 누르고 타겟 그룹 생성을 완료합니다.

5. Load Balancer 생성하기

AWS 콘솔 좌측 상단의 검색창에 Load Balancers를 입력하고 해당 페이지로 이동합니다.

우측 상단의 Create Load Balancer 버튼을 누른 후, Application Load Balancer를 선택합니다.

기본 설정 (Basic Configuration)

Scheme은 Internet-facing을 선택합니다.
IP 주소 유형은 IPv4를 선택합니다.

네트워크 매핑 및 보안 그룹 (Network Mapping & Security Groups)

가용 영역(Availability Zone)은 해당 리전(예: ap-northeast-2)의 모든 가용 영역을 선택합니다.
VPC ID와 Subnet ID는 서비스 생성 시 필요하므로 복사하여 저장해 둡니다.
보안 그룹은 이전에 생성했던 로드 밸런서용 보안 그룹을 선택합니다.

리스너 설정 (Listeners)

리스너는 생성한 타겟 그룹들과 연결합니다.

완료 (Finished)

로드 밸런서가 생성되면, 위 이미지에서 빨간 박스로 표시된 DNS 이름을 저장합니다. 서비스의 엔드포인트(ADM 등)에 접속할 때 이 주소를 사용하게 됩니다.

6. 서비스 생성하기

여기서는 콘솔의 GUI 대신 CloudFormation을 이용하여 서비스를 생성합니다. 이유는 GUI에서는 컨테이너의 여러 포트를 로드 밸런서에 연동하는 것을 지원하지 않기 때문입니다. 자세한 내용은 Medium에서 확인할 수 있습니다.

AWS 콘솔 좌측 상단의 검색창에 CloudFormation을 입력하고 해당 페이지로 이동합니다.

스택 생성하기 (Create Stack)

우측 상단의 Create Stack 버튼을 클릭합니다.

Choosing an existing template을 선택한 후, Upload a template file을 클릭합니다.
아래 JSON 형식을 사용해 템플릿 파일을 저장하고, 파일을 업로드합니다. 주석으로 표시된 부분은 사용자의 환경에 맞게 수정해야 합니다. (앞서 복사해 두었던 값들을 입력합니다.)
SecurityGroupIDs에는 이전에 생성한 태스크 보안 그룹의 ID를 입력합니다.

{
  "AWSTemplateFormatVersion": "2010-09-09",
  "Description": "The template used to create an ECS Service from the ECS Console.",
  "Parameters": {
    "SecurityGroupIDs": {
      "Type": "CommaDelimitedList"
      // "Default": "sg-0f21b327b83e33c46"
    },
    "SubnetIDs": {
      "Type": "CommaDelimitedList"
      // "Default": "subnet-0b7b40c10645ff898,subnet-059809f716cb81e9e,subnet-013907b4eb89d521f,subnet-020323a92b4d44e1e"
    },
    "VpcID": {
      "Type": "String"
      // "Default": "vpc-0ab885f61636987ee"
    },
    "LoadBalancerName": {
      "Type": "String"
      // "Default": "lb-test"
    }
  },
  "Resources": {
    "ECSService": {
      "Type": "AWS::ECS::Service",
      "Properties": {
        // "Cluster": "cluster-test",
        // "TaskDefinition": "arn:aws:ecs:ap-northeast-2:339...",
        "LaunchType": "EC2",
        // "ServiceName": "service-test",
        "SchedulingStrategy": "REPLICA",
        "DesiredCount": 1,
        "LoadBalancers": [
          {
            // "ContainerName": "container-test",
            "ContainerPort": 8000,
            "LoadBalancerName": {
              "Ref": "AWS::NoValue"
            }
            // "TargetGroupArn": "arn:aws:elasticloadbalancing:ap-northeast-2:339..."
          }
        ],
        "NetworkConfiguration": {
          "AwsvpcConfiguration": {
            "SecurityGroups": {
              "Ref": "SecurityGroupIDs"
            },
            "Subnets": {
              "Ref": "SubnetIDs"
            }
          }
        },
        "DeploymentConfiguration": {
          "MaximumPercent": 200,
          "MinimumHealthyPercent": 100,
          "DeploymentCircuitBreaker": {
            "Enable": true,
            "Rollback": true
          }
        },
        "DeploymentController": {
          "Type": "ECS"
        },
        "ServiceConnectConfiguration": {
          "Enabled": false
        },
        "PlacementStrategies": [
          {
            "Field": "attribute:ecs.availability-zone",
            "Type": "spread"
          },
          {
            "Field": "instanceId",
            "Type": "spread"
          }
        ],
        "PlacementConstraints": [],
        "Tags": [],
        "EnableECSManagedTags": true
      }
    }
  },
  "Outputs": {
    "ECSService": {
      "Description": "The created service.",
      "Value": {
        "Ref": "ECSService"
      }
    }
  }
}

헬스 체크 (Health Check)

Next를 클릭한 뒤 스택 이름을 입력하고, Next를 계속 클릭하여 Submit을 누르면 서비스 생성 요청이 완료됩니다.
클러스터 페이지로 이동하여 생성된 서비스의 페이지로 들어갑니다. 아래 이미지에서 빨간 박스로 표시된 버튼을 클릭합니다.

서비스가 성공적으로 생성되면, 아래 이미지에서 빨간 박스로 표시된 모든 항목이 healthy로 표시됩니다.

7. 완료

이제 앞서 저장한 <Load Balancer의 DNS>:8000으로 접속하면 아래와 같이 ADM 페이지가 잘 작동하는 것을 확인할 수 있습니다.

모든 설정이 완료되었으며, 배포 후 할당된 DNS를 통해 A2를 사용할 수 있습니다.

이 매뉴얼을 통해 A2를 AWS에 성공적으로 배포할 수 있습니다. 추가 문의 사항이 있으면 언제든지 지원팀에 연락해 주세요.

일반

​도커 이미지 ECR에 등록하기

​AWS ECS 설정하기

​1. 클러스터 생성하기

​2. 태스크 정의하기

​3. 보안 그룹 생성하기

​4. 타겟 그룹 생성하기

​5. Load Balancer 생성하기

​6. 서비스 생성하기

​7. 완료