Apache Flink アプリケーション用 Managed Serviceを作成して実行する

Java アプリケーションコードのダウンロード

1. 次のコマンドを使用してリモートリポジトリのクローンを作成します。

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

2. ./java/GettingStartedTable ディレクトリに移動します。

S3 バケットを参照して、アプリケーションによって書き込まれたファイルを観察する方法

1. 1. Amazon S3 コンソール (https://console.aws.amazon.com/s3/) を開きます。

2. 以前に作成したバケットを選択します。

3. output パスに移動したら、UTC タイムゾーンで現在の時間に対応する日付および時刻のフォルダに移動します。

4. 定期的に更新して、5 秒ごとに新しいファイルが表示されることを観察します。

5. 1 つのファイルを選択してダウンロードし、コンテンツを確認してください。

   注記

   デフォルトでは、ファイルには拡張子はありません。コンテンツは JSON 形式です。任意のテキストエディタでファイルを開いて、コンテンツを確認することができます。

アプリケーションコードをアップロードするには

1. Amazon S3 コンソール (https://console.aws.amazon.com/s3/) を開きます。

2. アプリケーションコード用に以前作成したバケットを選択します。

3. [アップロード] フィールドを選択します。

4. ファイルの追加を選択します。

5. 以前のセクションで生成された JAR ファイル (target/amazon-msf-java-table-app-1.0.jar) に移動します。

6. 他の設定を変更せずに [アップロード] を選択します。

   警告

   <repo-dir>/java/GettingStarted/target/amazon/msf-java-table-app-1.0.jar で正しい JAR ファイルを選択していることを確認してください。

   ターゲットディレクトリには、アップロードする必要のない他の JAR ファイルも含まれています。

1. にサインインし AWS マネジメントコンソール、https://console.aws.amazon.com/flink で Amazon MSF コンソールを開きます。

2. 正しいリージョンが選択されていることを確認してください: 米国東部 (バージニア北部) us-east-1。

3. 右側のメニューで [Apache Flink アプリケーション] を選択したら、[ストリーミングアプリケーションの作成] を選択します。または、最初のページの [開始方法] セクションで [ストリーミングアプリケーションの作成] を選択します。

4. [ストリーミングアプリケーションの作成] ページで、次の操作を完了します。

   • [ストリーム処理アプリケーションの設定方法の選択] には、[最初から作成] を選択します。

   • [Apache Flink の設定、Application Flink バージョン] には、[Apache Flink 1.19] を選択します。

   • [アプリケーション設定] セクションで、次の操作を完了します。

     • [アプリケーション名] には MyApplication と入力します。

     • [Description (説明)] に My Java Table API test app と入力します。

     • [アプリケーションリソースへのアクセス] には、[必要なポリシーを使用して IAM ロール kinesis-analytics-MyApplication-us-east-1 を作成/更新] を選択します。

   • [アプリケーション設定のテンプレート] で、次の操作を完了します。

     • [テンプレート] で [開発] を選択します。

5. [ストリーミングアプリケーションの作成] を選択します。

IAM ポリシーを編集して S3 バケット権限を追加するには

1. IAM コンソール (https://console.aws.amazon.com/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] ページで、[Congirue] を選択します。

2. [アプリケーションコードの場所] セクションで、[設定] を選択します。

   • [Amazon S3 バケット] には、アプリケーションコード用に以前作成したバケットを選択します。[参照] を選択して正しいバケットを選択したら、[選択] を選択します。バケット名はクリックしないでください。

   • [Amazon S3 オブジェクトへのパス] で、amazon-msf-java-table-app-1.0.jarと入力します。

3. [アクセス許可] には、[IAM ロールの作成 / 更新kinesis-analytics-MyApplication-us-east-1] を選択します。

4. [ランタイムプロパティ] セクションで、次のプロパティを追加します。

5. [新しい項目の追加] を選択して、次のパラメータをすべて追加します。

   グループ ID	キー	値
   bucket	name	your-bucket-name
   bucket	path	output

6. 他の設定を変更しないでください。

7. [Save changes] (変更の保存) をクリックします。

アプリケーションを実行するには

1. Amazon Managed Service for Apache Flink のコンソールページに戻り、[MyApplication] を選択します。

2. [Run] を選択してアプリケーションを起動します。

3. [アプリケーションの復元設定] で、[最新のスナップショットで実行] を選択します。

4. [Run] (実行) を選択します。

5. [アプリケーション詳細] の [ステータス] は「Ready」から「Starting」に移行し、アプリケーションが起動された後に「Running」に移行します。

ダッシュボードを開いてジョブを表示する方法

1. [Apache Flink ダッシュボードを開く] を選択します。ダッシュボードは新しいページで開かれます。

2. [実行中のジョブ] リストで、確認できる 1 つのジョブを選択します。

   注記

   ランタイムプロパティを設定したり、IAM ポリシーを誤って編集したりすると、アプリケーションのステータスが「Running」に変更されることがありますが、Flink ダッシュボードではジョブが継続的に再起動されていることが表示されます。ほれは、アプリケーションの設定が間違っているか、外部リソースへのアクセス許可がない場合の一般的な障害シナリオです。

   これが発生した場合、Flink ダッシュボードの [例外] タブを見て、問題の原因を調査します。

メトリクスを表示する方法

1. [更新] ボタンの横にあるドロップダウンリストから [10 秒] を選択します。

2. アプリケーションが実行中で正常なとき、[アップタイム] メトリクスが継続的に増加していることを確認できます。

3. [完全再起動] メトリクスはゼロである必要があります。増加している場合、設定に問題がある可能性があります。Flink ダッシュボードの [例外] タブを確認して、問題を調査します。

4. 正常なアプリケーションでは、[失敗したチェックポイント数] メトリクスは 0 です。

   注記

   このダッシュボードには、5 分の粒度で一定の一連のメトリクスが表示されます。CloudWatch ダッシュボードで任意のメトリクスを使用してカスタムアプリケーションのダッシュボードを作成できます。

アプリケーションを停止するには

1. [アクション] ドロップダウンリストで、[停止] を選択します。

2. [アプリケーション詳細] の [ステータス] は「Running」から「Stopping」に移行し、アプリケーションが完全に停止すると「Ready」に移行します。

   注記

   Python スクリプトまたは Kinesis Data Generator から入力ストリームへのデータ送信も必ず停止してください。