{"componentChunkName":"component---src-templates-blog-post-jsx","path":"/blog/how-to-setup-live-streaming-on-aws-elemental/","result":{"data":{"markdownRemark":{"excerpt":"Live streaming workflow on AWS can be achieved by integrating multiple services. For this, we will be using following services on AWS AWS…","html":"

Live streaming workflow on AWS can be achieved by integrating multiple services. For this, we will be using following services on AWS

\n\n

\n \n \n \n \n

\n

Apart from the workflow above, we will also be creating an archive group in Amazon S3 from the HLS output of MediaLive. This S3 will be source to Amazon Elemental MediaConvert which will convert input video into multiple output formats, to support viewing on a broad array of devices at varying resolutions.

\n

The workflow needs 2 major configurations

\n\n

AWS workflow setup

\n

Task 1: Create a MediaStore Container

\n
    \n
  1. Goto AWS Console → MediaStore.
    2. \n
  2. In Create a storage container, enter test_workflow_container_1.
    3. \n
  3. Click Create Container
    4. \n
\n

POST call

\n
POST / HTTP/1.1\nHost: mediastore.us-west-2.amazonaws.com\nx-amz-Date: 20170323T120000Z\nx-amz-target:ElementalMediaStoreService_20160711.CreateContainer\ncontent-type:application/x-amz-json-1.1\nContent-Length:30\nAuthorization: AWS4-HMAC-SHA256\nCredential=<API-KEY>/20141123/us-west-2/mediastore/aws4_request,\nSignedHeaders=host;x-amz-date;x-amz-mediastore-version,\nSignature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2\n{\n  \"ContainerName\": \"test_workflow_container_1\",\n}
\n

Task 2: Create an Amazon CloudFront Distribution

\n
    \n
  1. Goto AWS Console → CloudFront.
    2. \n
  2. On CloudFront Distribution page, click Create Distribution
    3. \n
  3. In Web section, click Get started
    4. \n
  4. Under Origin Settings, choose the MediaStore container you created above.\nNote: It may take a moment for the container to populate the drop-down list.
    5. \n
  5. For Origin Protocol Policy, select Match Viewer\nThis determines whether you want CloudFront to connect to your origin using only HTTP, only HTTPS or by matching protocol used by viewer.
    6. \n
  6. Leave all other settings to default and click Create Distribution
    7. \n
  7. The status for this newly created distribution will be In Progress. It will take around 20 minutes to provision the distribution and the status to update to Deployed
    8. \n
\n

CloudFront Distribution XML

\n
POST /2019-03-26/distribution HTTP/1.1\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<DistributionConfig xmlns=\"http://cloudfront.amazonaws.com/doc/2019-03-26/\">\n   <Origins>\n      <Items>\n         <Origin>\n            <CustomOriginConfig>\n               <OriginProtocolPolicy>Match Viewer</OriginProtocolPolicy>\n            </CustomOriginConfig>\n            <DomainName>3wdmrnzrlqfgto.data.mediastore.us-west-2.amazonaws.com</DomainName>\n            <Id>MS-3wdmrnzrlqfgto.data</Id>\n         </Origin>\n      </Items>\n      <Quantity>integer</Quantity>\n   </Origins>\n   <WebACLId>string</WebACLId>\n</DistributionConfig>
\n

Task 3: Setup MediaLive inputs

\n

MediaLive has 2 main components: Input which connects to the source and Channels which specify the encoding instructions and output destinations.

\n
    \n
  1. Goto AWS Console → MediaLive.
    2. \n
  2. \n

    Expand the navigation panel on left. Click Input → Create Input

    \n\n
    3. \n
  3. Click Create
    4. \n
  4. MediaLive adds input to the list of inputs.
    5. \n
\n

Note:

\n\n

Sample configuration

\n

\n \n \n \n \n

\n

9.Click Create Channel. Once the channel is created, Click Start. In a minute, the channel will be started.

\n

Task 9: Checking contents on MediaStore container

\n

At this point, the OBS is streaming the video. Once the MediaLive channel is up and running, it will begin creating object-based directories on the MediaStore container, in this case as hls-a and hls-b. Within those directories, there will be HLS master and variant manifests (.m3u8) and well as transport segments (.ts)

\n
    \n
  1. Go to AWS Console → MediaStore → test_workflow_container_1
    2. \n
  2. Under test_workflow_container_1: Items, there will still be no items. Click Refresh
    3. \n
  3. Now you will see hls-a directory. Click on hls-a to reveal its contents.
    4. \n
  4. Locate the parent manifest: stream-a.m3u8
    5. \n
  5. Click this manifest stream-a.m3u8
    6. \n
  6. Under object name, copy the object name URL which looks something like https://bftwstdfnjd3og.data.mediastore.us-west-2.amazonaws.com/hls-a/stream-a.m3u8
    7. \n
  7. You can test this stream by running the command curl -vvv https://bftwstdfnjd3og.data.mediastore.us-west-2.amazonaws.com/hls-a/stream-a.m3u8
    8. \n
  8. This results in 403 Forbidden error
    9. \n
\n

Task 10: Edit MediaStore Container and CORS policy

\n
    \n
  1. Go to AWS Console → MediaStore → test_workflow_container_1
    2. \n
  2. Move to Container Policy section and click Edit Policy
    3. \n
  3. Enter the policy as
    4. \n
\n

MediaStore container Policy

\n
{\n  \"Version\" : \"2012-10-17\",\n  \"Statement\" : [ {\n    \"Sid\" : \"MediaStoreFullAccess\",\n    \"Effect\" : \"Allow\",\n    \"Principal\" : {\n      \"AWS\" : \"arn:aws:iam::361242680605:root\"\n    },\n    \"Action\" : \"mediastore:*\",\n    \"Resource\" : \"arn:aws:mediastore:us-west-2:361242680605:container/test_workflow_container_1/*\",\n    \"Condition\" : {\n      \"Bool\" : {\n        \"aws:SecureTransport\" : \"true\"\n      }\n    }\n  }, {\n    \"Sid\" : \"MediaStorePostToSpecificPath\",\n    \"Effect\" : \"Allow\",\n    \"Principal\" : {\n      \"Service\" : \"medialive.amazonaws.com\"\n    },\n    \"Action\" : \"mediastore:PutObject\",\n    \"Resource\" : \"arn:aws:mediastore:us-west-2:361242680605:container/test_workflow_container_1/*\",\n    \"Condition\" : {\n      \"Bool\" : {\n        \"aws:SecureTransport\" : \"true\"\n      }\n    }\n  }, {\n    \"Sid\" : \"PublicReadOverHttps\",\n    \"Effect\" : \"Allow\",\n    \"Principal\" : \"*\",\n    \"Action\" : [ \"mediastore:GetObject\", \"mediastore:DescribeObject\" ],\n    \"Resource\" : \"arn:aws:mediastore:us-west-2:361242680605:container/test_workflow_container_1/*\",\n    \"Condition\" : {\n      \"Bool\" : {\n        \"aws:SecureTransport\" : \"true\"\n      }\n    }\n  } ]\n}
\n
    \n
  1. Also Edit the CORS policy as
    2. \n
\n

MediaStore CORS Policy

\n
[\n  {\n    \"AllowedHeaders\": [\n      \"*\"\n    ],\n    \"AllowedMethods\": [\n      \"GET\"\n    ],\n    \"AllowedOrigins\": [\n      \"*\"\n    ],\n    \"ExposeHeaders\": [\n      \"*\"\n    ],\n    \"MaxAgeSeconds\": 3000\n  }\n]
\n

Task 11: Edit CloudFront Cache behavior to set up CORS

\n
    \n
  1. Go to AWS Console → CloudFront. Select your distribution and click Distribution Settings
    2. \n
  2. Click on Behaviors tab. Select your origin and click Edit.
    3. \n
  3. For Cache Based on Selected Request Headers, Select Whitelist
    4. \n
  4. For Whitelist Headers, Select Origin and click Add>>
    5. \n
  5. Leave rest as default. Scroll down to the last and click Yes edit
    6. \n
\n

This will take some time to propagate.

\n

Task 12: Check playout of stream from MediaStore and CloudFront

\n

MediaStore stream:\n1. Go to AWS Console → MediaStore → test_workflow_container_1\n2. Click hls-a and look for manifest stream-a.m3u8. Click the manifest and look for object name URL something like https://bftwstdfnjd3og.data.mediastore.us-west-2.amazonaws.com/hls-a/stream-a.m3u8\n3. Open this URL in new tab https://www.jwplayer.com/developers/stream-tester/ and paste above streaming URL in File URL field and test the stream

\n

CloudFront stream:\n1. Go to AWS Console → CloudFront. Click on your created distribution and copy the Domain Name\n\n \n \n \n2. Edit the stream-a.m3u8 URL from https://bftwstdfnjd3og.data.mediastore.us-west-2.amazonaws.com/hls-a/stream-a.m3u8 to https://d1b2i1qy1t8sra.cloudfront.net/hls-a/stream-a.m3u8\n3. Open this URL in new tab https://www.jwplayer.com/developers/stream-tester/ and paste above CloudFront URL in File URL and test the stream

\n

Voila! You are done!

","fields":{"slug":"/how-to-setup-live-streaming-on-aws-elemental/"},"frontmatter":{"title":"Live Streaming on AWS Elemental","summary":"Architecture setup for Live Streaming on AWS Elemental Service","date":"28-07-2020T15:00:00+05:30","dateModified":"28-07-2020T15:00:00+05:30","thumbnail":"/blogImages/AWS-Elemental/cover.jpeg"}}},"pageContext":{"slug":"/how-to-setup-live-streaming-on-aws-elemental/","modifiedDate":"28-07-2020T15:00:00+05:30"}},"staticQueryHashes":[]}