Managed Service for Apache Flink 애플리케이션 생성 및 실행

Java 애플리케이션 코드를 다운로드하려면

1. 다음 명령을 사용하여 원격 리포지토리를 복제합니다.

   git clone https://github.com/aws-samples/amazon-managed-service-for-apache-flink-examples.git

2. ./java/GettingStartedTable 디렉터리로 이동합니다.

S3 버킷을 찾아보고 애플리케이션이 작성한 파일을 관찰하려면

1. 1. https://console.aws.amazon.com/s3/에서 S3 콘솔을 엽니다.

2. 이전에 생성한 버킷을 선택합니다.

3. output 경로로 이동한 다음 UTC 시간대의 현재 시각에 해당하는 날짜 및 시간 폴더로 이동합니다.

4. 5초마다 새 파일이 나타나는 것을 관찰할 수 있도록 주기적으로 새로 고칩니다.

5. 파일 하나를 선택하고 다운로드하여 콘텐츠를 관찰합니다.

   참고

   파일에는 기본적으로 확장자가 없습니다. 콘텐츠는 JSON 형식으로 구성되어 있습니다. 파일은 어떤 텍스트 편집기로든 열어 그 내용을 확인할 수 있습니다.

애플리케이션 코드를 업로드하려면

1. https://console.aws.amazon.com/s3/에서 S3 콘솔을 엽니다.

2. 애플리케이션 코드를 위해 이전에 생성한 버킷을 선택합니다.

3. 업로드 필드를 선택합니다.

4. Add Files를 선택합니다.

5. 이전 섹션 target/amazon-msf-java-table-app-1.0.jar에서 생성한 JAR 파일로 이동합니다.

6. 다른 설정을 변경하지 않고 업로드를 선택합니다.

   주의

   <repo-dir>/java/GettingStarted/target/amazon/msf-java-table-app-1.0.jar에서 반드시 올바른 JAR 파일을 선택해야 합니다.

   대상 디렉터리에는 업로드할 필요가 없는 다른 JAR 파일도 포함되어 있습니다.

1. 에 로그인 AWS Management 콘솔하고 https://console.aws.amazon.com/flink Amazon MSF 콘솔을 엽니다.

2. 미국 동부(버지니아 북부) us-east-1 리전이 올바르게 선택되었는지 확인합니다.

3. 오른쪽 메뉴에서 Apache Flink 애플리케이션을 선택한 다음 스트리밍 애플리케이션 생성을 선택합니다. 또는 초기 페이지의 시작하기 섹션에서 스트리밍 애플리케이션 생성을 선택합니다.

4. 스트리밍 애플리케이션 생성 페이지에서 다음을 완료합니다.

   • 스트림 처리 애플리케이션을 설정하는 방법 선택에서 처음부터 생성을 선택합니다.

   • Apache Flink 구성의 애플리케이션 Flink 버전에서 Apache Flink 1.19를 선택합니다.

   • 애플리케이션 구성 섹션에서 다음을 완료합니다.

     • 애플리케이션 명칭에 MyApplication을 입력합니다.

     • 설명에 My Java Table API test app를 입력합니다.

     • 애플리케이션 리소스에 대한 액세스에서 필요한 정책이 포함된 IAM 역할 kinesis-analytics-MyApplication-us-east-1 생성 및 업데이트를 선택합니다.

   • 애플리케이션 설정 템플릿에서 다음을 완료합니다.

     • 템플릿에서 개발을 선택합니다.

5. 스트리밍 애플리케이션 생성을 선택합니다.

IAM 정책을 편집하여 S3 버킷 권한을 추가하려면

1. https://console.aws.amazon.com/iam/에서 IAM 콘솔을 여세요.

2. 정책을 선택하세요. 이전 섹션에서 콘솔이 생성한 kinesis-analytics-service-MyApplication-us-east-1 정책을 선택합니다.

3. 편집을 선택한 후 JSON 탭을 선택합니다.

4. 다음 정책 예제의 강조 표시된 부분을 정책에 추가하세요. 샘플 계정 ID(012345678901)는 사용자 계정 ID로, <bucket-name>은 생성한 S3 버킷 이름으로 각각 변경합니다.

   JSON

   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "ReadCode",
               "Effect": "Allow",
               "Action": [
                   "s3:GetObject",
                   "s3:GetObjectVersion"
               ],
               "Resource": [
                   "arn:aws:s3:::amzn-s3-demo-bucket/kinesis-analytics-placeholder-s3-object"
               ]
           },
           {
               "Sid": "ListCloudwatchLogGroups",
               "Effect": "Allow",
               "Action": [
                   "logs:DescribeLogGroups"
               ],
               "Resource": [
                   "arn:aws:logs:us-east-1:123456789012:*"
               ]
           },
           {
               "Sid": "ListCloudwatchLogStreams",
               "Effect": "Allow",
               "Action": [
                   "logs:DescribeLogStreams"
               ],
               "Resource": [
                   "arn:aws:logs:us-east-1:123456789012:log-group:/aws/kinesis-analytics/MyApplication:log-stream:*"
               ]
           },
           {
               "Sid": "PutCloudwatchLogs",
               "Effect": "Allow",
               "Action": [
                   "logs:PutLogEvents"
               ],
               "Resource": [
                   "arn:aws:logs:us-east-1:123456789012:log-group:/aws/kinesis-analytics/MyApplication:log-stream:kinesis-analytics-log-stream"
               ]
           }, 
           {
               "Sid": "WriteOutputBucket", 
               "Effect": "Allow", 
               "Action": "s3:*", 
               "Resource": [
                   "arn:aws:s3:::amzn-s3-demo-bucket2"
               ]
          }
       ]
   }
   

5. 다음과 변경 사항 저장을 차례로 선택합니다.

애플리케이션을 구성하려면

1. MyApplication 페이지에서 구성을 선택합니다.

2. 애플리케이션 코드 위치 섹션에서 구성을 선택합니다.

   • Amazon S3 버킷의 경우 애플리케이션 코드를 위해 이전에 생성한 버킷을 선택합니다. 찾아보기를 선택하고 올바른 버킷을 선택한 다음 선택을 선택합니다. 버킷 이름을 클릭하지 마세요.

   • Amazon S3 객체 경로에는 amazon-msf-java-table-app-1.0.jar를 입력합니다.

3. 액세스 권한에서 IAM 역할 kinesis-analytics-MyApplication-us-east-1 생성/업데이트를 선택합니다.

4. 런타임 속성 섹션에서 다음 속성을 추가합니다.

5. 새 항목 추가를 선택하고 다음 각 파라미터를 추가합니다.

   그룹 ID	Key(키)	값
   bucket	name	your-bucket-name
   bucket	path	output

6. 다른 설정은 수정하지 않습니다.

7. 변경 사항 저장을 선택합니다.

애플리케이션을 실행하려면

1. Amazon Managed Service for Apache Flink 콘솔 페이지로 돌아가 MyApplication을 선택합니다.

2. 실행을 선택하여 애플리케이션을 시작합니다.

3. 애플리케이션 복원 구성에서 최신 스냅샷으로 실행을 선택합니다.

4. 실행을 선택합니다.

5. 애플리케이션 세부 정보의 상태는 애플리케이션이 시작된 후 Ready에서 Starting으로 그리고 Running으로 전환됩니다.

대시보드를 열고 작업을 보려면

1. Apache Flink 대시보드 열기를 선택합니다. 대시보드가 새 페이지에서 열립니다.

2. 실행 중인 작업 목록에서 보이는 단일 작업을 선택합니다.

   참고

   런타임 속성을 잘못 설정하거나 IAM 정책을 잘못 편집한 경우 애플리케이션 상태는 Running으로 변경될 수 있지만, Flink 대시보드에는 작업이 계속 재시작되는 것으로 표시됩니다. 이는 애플리케이션이 잘못 구성되었거나 외부 리소스에 액세스할 권한이 부족할 때 흔히 발생하는 장애 시나리오입니다.

   이러한 상황이 발생하면 Flink 대시보드의 예외 탭을 확인하여 문제의 원인을 조사합니다.

지표를 보려면

1. 새로 고침 버튼 옆의 드롭다운 목록에서 10 seconds를 선택합니다.

2. 애플리케이션이 실행 중이고 정상이면 가동 시간 지표가 계속 증가하는 것을 확인할 수 있습니다.

3. fullrestarts 지표는 0이어야 합니다. 값이 증가하고 있다면 구성에 문제가 있을 수 있습니다. Flink 대시보드의 예외 탭을 검토하여 문제를 조사합니다.

4. 실패한 체크포인트 수 지표는 정상 애플리케이션에서는 0이어야 합니다.

   참고

   이 대시보드는 고정된 지표 세트를 5분 단위로 표시합니다. CloudWatch 대시보드에서 어떤 지표든 사용하여 사용자 지정 애플리케이션 대시보드를 생성할 수 있습니다.

애플리케이션을 중지하려면

1. 작업 드롭다운 목록에서 정지를 선택합니다.

2. 애플리케이션 세부 정보의 상태는 애플리케이션이 완전히 중지되면 Running에서 Stopping으로 그리고 Ready로 전환됩니다.

   참고

   Python 스크립트 또는 Kinesis Data Generator에서 입력 스트림으로 데이터를 전송하는 것도 잊지 말고 중단합니다.