Automated deployment - Live Streaming on AWS with MediaStore

Automated deployment

Before you launch the automated deployment, review the considerations discussed in this guide. Follow the step-by-step instructions in this section to configure and deploy the solution into your account.

Time to deploy: Approximately five minutes

Prerequisites

Before you launch the Live Streaming on AWS with MediaStore solution, you must create an AWS Identity and Access Management (IAM) role and associated policy, to enable MediaStore access to Amazon CloudWatch. Launching this solution without an IAM role and policy will be successful. However, the deployed Amazon CloudWatch dashboard will not be configured. For details on how to create an IAM role and policy, see the AWS Elemental MediaStore documentation.

Note

This solution only requires one policy and role per account. However, they must be named MediaStoreAccessLogsPolicy and MediaStoreAccessLogs. The same role and policy will work for all deployments of this solution in any supported Region.

Launch the stack

This automated AWS CloudFormation template deploys the Live Streaming on AWS with MediaStore solution on the AWS Cloud. Verify that you have created an AWS Elemental MediaStore IAM role and policy before deploying this solution.

Note

You are responsible for the cost of the AWS services used while running this solution. See the Cost section for more details. For full details, see the pricing webpage for each AWS service you use in this solution.

  1. Log in to the AWS Management Console and select the button below to launch the live-streaming-on-aws-with-mediastore AWS CloudFormation template.

    
                                Live Streaming launch button

    You can also download the template as a starting point for your own implementation.

  2. The template launches in the US East (N. Virginia) Region by default. To launch this solution in a different AWS Region, use the Region selector in the console navigation bar.

    Note

    This solution uses the AWS Elemental MediaLive and MediaStore services, which are currently available in specific AWS Regions only. Therefore, you must launch this solution in an AWS Region where these services are available. For the most current service availability by Region, see the AWS service offerings by Region.

  3. On the Create stack page, verify that the correct template shows in the Amazon S3 URL text box and choose Next.

  4. On the Specify stack details page, assign a name to your solution stack.

  5. Under Parameters, review the parameters for the template, and modify them as necessary. This solution uses the following default values.

    Parameter Default Description
    Deployment Options
    Source Input Type URL_PULL Specify the input type for MediaLive: RTP_PUSH, RTMP_PUSH, URL_PULL (HLS), or INPUT_DEVICE (AWS Elemental Link). Detailed instructions for each input type can be found in the appendix.
    Source URL <Optional input> If you selected URL_PULL for Source Input Type, enter the URL for your source stream. By, default this parameter contains the primary demo source URL.
    Source Username <Optional input> If you selected URL_PULL for Source Input Type, enter the username for your source stream if using authentication. This value will be stored securely in AWS Systems Manager Parameter Store.
    Source Password <Optional input> If you selected URL_PULL for Source Input Type, enter the password for your source stream if using authentication. This value will be stored securely in AWS Systems Manager Parameter Store.
    Input Security Group CIDR Block <Optional input> For RTP_PUSH and RTMP_PUSH input types, specify the CIDR block to restrict access to the MediaLive input endpoint. This should be the IP or IP range of your source stream location/network.
    Encoding Profile 720 Specify the encoding profile to use with MediaLive.
    Start MediaLive Channel True Choose whether to start the MediaLive channel when the solution is created. We recommend starting the channel if you will use the demo preview player.
  6. Choose Next.

  7. On the Options page, choose Next.

  8. On the Review page, review and confirm the settings. Be sure to check the box acknowledging that the template will create AWS Identity and Access Management (IAM) resources.

  9. Choose Create to deploy the stack.

    You can view the status of the stack in the AWS CloudFormation console in the Status column. You should see a status of CREATE_COMPLETE in approximately five minutes.

    Note

    To test the live stream playback, navigate to the AWS CloudFormation stack Outputs tab, copy the Amazon CloudFront URL, and open the URL in any player compatible with HTTP Live Streaming (HLS). In the Outputs tab, you can also find links to the MediaLive and MediaStore console, and the Amazon CloudWatch dashboard. For more details, see Appendix D.