Create and Run a Kinesis Data Analytics for Apache Flink Application

1. Connect to the client instance you created in Step 4: Create a Client Machine of the Getting Started Using Amazon MSK tutorial.

2. Install Python3, Pip, and the Kafka Python library:

   $ sudo yum install python37
   $ curl -O https://bootstrap.pypa.io/get-pip.py
   $ python3 get-pip.py --user
   $ pip install kafka-python
   

3. Create a file named stock.py with the following contents. Replace the BROKERS value with your bootstrap broker list you recorded previously.

   import datetime
       import json
       import random
       import boto3
   
       STREAM_NAME = "ExampleInputStream"
   
   
       def get_data():
           return {
               'event_time': datetime.datetime.now().isoformat(),
               'ticker': random.choice(['AAPL', 'AMZN', 'MSFT', 'INTC', 'TBV']),
               'price': round(random.random() * 100, 2)}
   
   
       def generate(stream_name, kinesis_client):
           while True:
               data = get_data()
               print(data)
               kinesis_client.put_record(
                   StreamName=stream_name,
                   Data=json.dumps(data),
                   PartitionKey="partitionkey")
   
   
       if __name__ == '__main__':
           generate(STREAM_NAME, boto3.client('kinesis', region_name='us-west-2'))
   

4. Later in the tutorial, you run the stock.py script to send data to the application.

   $ python3 stock.py

To download the Java application code

1. Clone the remote repository using the following command:

   git clone https://github.com/aws-samples/amazon-kinesis-data-analytics-java-examples

2. Navigate to the amazon-kinesis-data-analytics-java-examples/GettingStartedTable directory.

To compile the application code

1. To use your application code, you compile and package it into a JAR file. You can compile and package your code in one of two ways:

   • Use the command-line Maven tool. Create your JAR file by running the following command in the directory that contains the pom.xml file:

     mvn package -Dflink.version=1.15.3

   • Use your development environment. See your development environment documentation for details.

     Note

     The provided source code relies on libraries from Java 11.

   You can either upload your package as a JAR file, or you can compress your package and upload it as a ZIP file. If you create your application using the Amazon CLI, you specify your code content type (JAR or ZIP).

2. If there are errors while compiling, verify that your JAVA_HOME environment variable is correctly set.

To upload the application code

1. Open the Amazon S3 console at https://console.amazonaws.cn/s3/.

2. Choose Create bucket.

3. Enter ka-app-code-<username> in the Bucket name field. Add a suffix to the bucket name, such as your user name, to make it globally unique. Choose Next.

4. In the Configure options step, keep the settings as they are, and choose Next.

5. In the Set permissions step, keep the settings as they are, and choose Next.

6. Choose Create bucket.

7. In the Amazon S3 console, choose the ka-app-code-<username> bucket, and choose Upload.

8. In the Select files step, choose Add files. Navigate to the aws-kinesis-analytics-java-apps-1.0.jar file that you created in the previous step. Choose Next.

9. You don't need to change any of the settings for the object, so choose Upload.

1. Open the Kinesis Data Analytics console at https://console.amazonaws.cn/kinesisanalytics.

2. On the Kinesis Data Analytics dashboard, choose Create analytics application.

3. On the Kinesis Analytics - Create application page, provide the application details as follows:

   • For Application name, enter MyApplication.

   • For Description, enter My java test app.

   • For Runtime, choose Apache Flink.

   • Leave the version as Apache Flink version 1.15.2 (Recommended version).

4. For Access permissions, choose Create / update IAM role kinesis-analytics-MyApplication-us-west-2.

5. Choose Create application.

To edit the IAM policy to add S3 bucket permissions

1. Open the IAM console at https://console.amazonaws.cn/iam/.

2. Choose Policies. Choose the kinesis-analytics-service-MyApplication-us-west-2 policy that the console created for you in the previous section.

3. On the Summary page, choose Edit policy. Choose the JSON tab.

4. Add the highlighted section of the following policy example to the policy.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
           "Sid": "S3",
           "Effect": "Allow",
           "Action": [
               "s3:Abort*",
               "s3:DeleteObject*",
               "s3:GetObject*",
               "s3:GetBucket*",
               "s3:List*",
               "s3:ListBucket",
               "s3:PutObject"
           ],
           "Resource": [
               "arn:aws:s3:::ka-app-code-<username>",
               "arn:aws:s3:::ka-app-code-<username>/*"
           ]
           },
           {
               "Sid": "DescribeLogGroups",
               "Effect": "Allow",
               "Action": [
                   "logs:DescribeLogGroups"
               ],
               "Resource": [
                   "arn:aws:logs:us-west-2:012345678901:log-group:*"
               ]
           },
           {
               "Sid": "DescribeLogStreams",
               "Effect": "Allow",
               "Action": [
                   "logs:DescribeLogStreams"
               ],
               "Resource": [
                   "arn:aws:logs:us-west-2:012345678901:log-group:/aws/kinesis-analytics/MyApplication:log-stream:*"
               ]
           },
           {
               "Sid": "PutLogEvents",
               "Effect": "Allow",
               "Action": [
                   "logs:PutLogEvents"
               ],
               "Resource": [
                   "arn:aws:logs:us-west-2:012345678901:log-group:/aws/kinesis-analytics/MyApplication:log-stream:kinesis-analytics-log-stream"
               ]
           }
        ]
   }

To configure the application

1. On the MyApplication page, choose Configure.

2. On the Configure application page, provide the Code location:

   • For Amazon S3 bucket, enter ka-app-code-<username>.

   • For Path to Amazon S3 object, enter aws-kinesis-analytics-java-apps-1.0.jar.

3. Under Access to application resources, for Access permissions, choose Create / update IAM role kinesis-analytics-MyApplication-us-west-2.

4. Under Properties, choose Create group.

5. Enter the following:

   Group ID	Key	Value
   FlinkApplicationProperties	kafka-topic	AWSKafkaTutorialTopic
   FlinkApplicationProperties	brokers	Your Amazon MSK cluster's Bootstrap Brokers list
   FlinkApplicationProperties	s3Path	ka-app-code-<username>
   FlinkApplicationProperties	security.protocol	SSL
   FlinkApplicationProperties	ssl.truststore.location	/usr/lib/jvm/java-11-amazon-corretto/lib/security/cacerts
   FlinkApplicationProperties	ssl.truststore.password	changeit

6. Under Monitoring, ensure that the Monitoring metrics level is set to Application.

7. For CloudWatch logging, select the Enable check box.

8. In the Virtual Private Cloud (VPC) section, choose VPC configuration based on Amazon MSK cluster. Choose AWSKafkaTutorialCluster.

9. Choose Update.

To run the application

1. On the MyApplication page, choose Run. Confirm the action.

2. When the application is running, refresh the page. The console shows the Application graph.

3. From your Amazon EC2 client, run the Python script you created previously to write records to the Amazon MSK cluster for your application to process:

   $ python3 stock.py