Note: Please go to docs.rightscale.com to access the current RightScale documentation set. Also, feel free to Chat with us!
Home > Reference Info > Dashboard Help Text > Acf_distributions

Acf_distributions

Table of Contents

New

To create a CloudFront distribution of objects stored in an S3 bucket, you must follow the steps below.

  1. Sign-up for Amazon CloudFront.
  2. Configure the S3 bucket and its objects.
  3. Create a CloudFront Distribution.

You can either either create a 'Basic' distribution to server public/private static content or a 'Streaming' distribution for streaming on-demand media files.

  • Nickname - A short nickname that helps you recognize the distribution.
  • Comment - (optional) Provide a brief description about the distribution.
  • Origin type - The content that's delivered by CloudFront is stored on an origin server. You can either use an S3 bucket as the origin server or select 'custom' to define a different origin server that exists outside of S3.

  • Origin Type: S3

    • S3 Bucket - Select the S3 bucket that contains the objects for your distribution. Once you create a distribution, you can't change the S3 bucket that's associated with it. Also, the selected S3 Bucket can only have lower case alphanumeric characters, dots, and dashes in its namespace. By default, only S3 buckets with valid names will be displayed in the dropdown menu.
    • Origin Access Identity - The virtual identity that will be used to give your CF distribution permission to fetch a private object from your origin server (S3 bucket). Use the OAI to configure the distribution so that end users can only access objects in an Amazon S3 bucket (origin server) through a CloudFront distribution.
  • Origin Type: custom

    • DNS name - Specify the origin to associate with the CF distribution. You must use a valid DNS name. Ex: www.site.com
    • HTTP port - The HTTP port the custom origin listens on. Ex: 80
    • HTTPS port - The HTTPS port the custom origin listens on. Ex: 443
    • Origin protocol policy - The original protocol policy to apply to your origin.
    • http-only - CF will only access and fetch objects from the origin server using HTTP.
    • match-viewer - CF will use either HTTP or HTTPS to access and fetch objects from the origin server based on the protocol of the client request.
  • CNAME(s) - Each object of a distribution will be given a unique CloudFront url (Ex: https://mybucketname.cloudfront.amaz...ages/image.jpg) where the name of your S3 bucket is used as the subdomain prefix. However, you can associate a CNAME alias with a distribution so that you can include your own domain name in the object's url instead of the one assigned by Amazon (ex: http: mydistribution.mysite.com/images/image.jpg).

  • Trusted Signer(s): Comma-separated list of AWS accounts that have permission to create signed URLs for a given distribution's "private" content. (Ex: 1234-1234-1234)
  • Default root object - Designates a default root object that will be served when a client request points to your distribution's root url instead of a specific object in your CF distribution. (Ex: index.html)
  • Logging bucket - If you want logging enabled, specify the location of the S3 bucket where gzipped access log data will be stored. (e.g. mybucket.s3.amazonaws.com) Log data will be saved as a gzipped file in a 'logging' folder in the specified S3 bucket. Leave this field blank to disable logging.
  • Logging prefix - An optional prefix that can be prepended to the gzipped filename. (e.g. my/log/path/)
    • Example format for logging bucket with prefix filename is: {Bucket}.s3.amazonaws.com/{OptionalPrefixYouChoose}{Distribution ID}.{YYYY}-{MM}-{DD}-{HH}.{Unique ID}.gz
    • Example filename: myapplogs.s3.amazonaws.com/myappprefix/EMLARXS993KSTG8.2010-03-17-20.RT4KCN4SGK9.gz
  • Https only - If selected, only HTTPS requests are permitted. If not selected, both HTTP and HTTPS requests are permitted.
  • Enabled - Add a checkmark to enable the distribution and make it active.
Clouds > AWS Global > CloudFront > New

Index

Amazon CloudFront is a content distribution network for delivering static content stored in your S3 buckets. Distributions provide an efficient way of delivering key content to end users all over the world by using a global network of "edge locations." An edge location is a geographical site where CloudFront caches copies of commonly downloaded objects such as web pages, images, media files, etc. Your S3 bucket (origin server) contains the master copy of an object. When a user requests one of the objects in your distribution, CloudFront determines which edge location is best able to serve the request in order to ensure optimal download performance for the end user. If a copy of the object does not already exist at the edge location, CloudFront will grab a copy of the object and place it at the appropriate edge location, where it will remain cached for 1 hour (default). Each AWS account can have up to 100 distributions.

Before you can use Amazon CloudFront distributions, you must first sign-up for the service.

This page displays the following CloudFront information:

  • Nickname - A user specified nickname for the CF distribution
  • Identification (ID) - Unique identifier that is autogenerated by AWS during the creation process and assigned to the distribution (e.g. E2Q0AOE2Q0AOL)
  • Type - The type of CF distribution (basic or streaming)
  • Origin Type - The type of storage that will be used as the origin server, which stores master copies of the assets that will be served by CloudFront. (e.g. S3 or custom)
  • DNS Name - The DNS name of the origin server. (e.g. For S3, it would be 'mybucket.s3.amazonaws.com')
  • S3 Bucket - Name of the S3 bucket that will serve as the "origin server" for your distribution. It will contain the master copies of your objects. (e.g. mybucket)
  • Domain - The CloudFront domain name you need to use when linking to your objects. (e.g. d60472d6047qy9.mysite.com). You will use the domain name to construct a link to an object. (e.g. http://<domain>/image.jpg or http://d60472d6047qy9.mysite.com>/image.jpg)</domain>
  • Origin Access Identity - The virtual identity that will be used to give your CF distribution permission to fetch a private object from your origin server (S3 bucket). Use the OAI to configure the distribution so that end users can only access objects in an Amazon S3 bucket (origin server) through a CloudFront distribution.
  • Last modified - Date and timestamp of when the distribution was last modified.
  • Logging - If enabled, you must define an S3 bucket and a path prefix to store access logs. With logging enabled for your distribution, gzipped access logs are stored in a 'logging' folder of your S3 bucket.
  • Status - Current status of the distribution.
    • Deployed (ready to use) or InProgress (created or updated, but not quite ready for use)
  • Enabled - A distribution can only serve content if the distribution is enabled. It takes up to 15 minutes to disable a distribution. When you disable a distribution, it will be taken offline; CloudFront will no longer accept end user requests for content from the distribution.
  • Https only - If selected, only HTTPS requests are permitted. If not selected, both HTTP and HTTPS requests are permitted.
  • Actions - Edit or Delete the CloudFront distribution.

Action Buttons

  • New Basic Distribution - Create a new basic CloudFront distribution for serving primarily static content over standard HTTP/HTTPS protocol.
  • New Streaming Distribution - Create a new streaming CloudFront distribution for streaming primarily on-demand media files over RMTP.
Clouds > AWS Global > CloudFront > Index

- -

Show

This page displays the following CloudFront information:

  • ID - Unique ID that is autogenerated by AWS during the creation process.
  • Type - The type of CF distribution (basic or streaming)
  • Origin type - The type of storage that will be used as the origin server, which stores master copies of the assets that will be served by CloudFront. (e.g. S3 or custom)
  • Domain - The CloudFront domain name you need to use when linking to your objects. (e.g. d60472d6047qy9.mysite.com). You will use the domain name to construct a link to an object. (e.g. http://<domain>/image.jpg or http://d60472d6047qy9.mysite.com>/image.jpg)</domain>
  • DNS name - The DNS name of the origin server. (e.g. For S3, it would be 'mybucket.s3.amazonaws.com')
  • S3 Bucket - Name of the S3 bucket that will serve as the "origin server" for your distribution. It will contain the master copies of your objects. (e.g. mybucket)
  • Origin Access Identity - The virtual identity that will be used to give your CF distribution permission to fetch a private object from your origin server (S3 bucket). Use the OAI to configure the distribution so that end users can only access objects in an Amazon S3 bucket (origin server) through a CloudFront distribution.
  • CNAME(s) - List of CNAME(s) that will be used for served objects. (e.g. assets.mysite.com)
  • Default root object - The default root object that will be served when a client request points to your distribution's root url instead of a specific object in your CF distribution. (Ex: index.html)
  • Trusted Signer(s): Comma-separated list of AWS accounts that have permission to create signed URLs for a given distribution's content. To add your own AWS account, add 'self' to the list. (You cannot create signed URLs in the Dashboard. However, once you create them in the AWS Console, they will be displayed here.)
  • Active Trusted Signer(s): Only trusted signers with valid keys can create signed URLs. (You cannot create a key pair in the Dashboard. However, once you create them in the AWS Console, they will be displayed here.)
  • Logging - Is logging enabled for this CF distribution? (Enabled or Disabled)
  • Status - Current status of the distribution. Deployed (ready to use) or InProgress (created or updated, but not quite ready for use)
  • Enabled - Enabled (distribution is working and accessible) or Disabled (access to this distribution is no longer available)
  • HTTPS only - If enabled, only HTTPS requests are permitted. If not disabled, both HTTP and HTTPS requests are permitted.
  • Locked - Lock a distribution to prevent any changes from being made to the distribution's configuration. Objects can still be added to the origin server.
  • Last modified - Date and timestamp when the distribution was last modified.
  • Comment - Optional information about the CF distribution. Maximum length of 128 characters. It can be edited at any time.

Action Buttons

  • Edit - Edit a CF distribution's configuration
  • Delete - Delete a CF distribution
Clouds > AWS Global > CloudFront > Show

Edit

Edit the following parameters for the Cloudfront distribution. If you wish to change its nickname or lock the distribution, you can do so at the distribution's home page.

  • Comment - (optional) Provide a brief description about the distribution.
  • CNAME(s) - Each object of a distribution will be given a unique CloudFront url (ex: https://mybucketname.cloudfront.amaz...ages/image.jpg) where the name of your S3 bucket is used as the subdomain prefix. However, you can associate a CNAME alias with a distribution so that you can include your own domain name in the object's url instead of the one assigned by Amazon (ex: http: distribution.mysite.com/images/image.jpg).
  • Origin Access Identity - The name of the OAI that's being used by the distribution.
  • **Trusted Signer(s): List of AWS accounts that have permission to create signed URLs for a given distribution's content.
  • Logging bucket - The location of the S3 bucket where gzipped access log data will be stored. (e.g. mybucket.s3.amazonaws.com) Log data will be saved as a gzipped file in a 'logging' folder in the specified S3 bucket. Leave this field blank to disable logging.
  • Logging prefix - An optional prefix that can be prepended to the gzipped filename. (e.g. my/log/path/)
    • Example format for logging bucket with prefix filename is: {Bucket}.s3.amazonaws.com/{OptionalPrefixYouChoose}{Distribution ID}.{YYYY}-{MM}-{DD}-{HH}.{Unique ID}.gz
    • Example filename: myapplogs.s3.amazonaws.com/myappprefix/EMLARXS993KSTG8.2009-03-17-20.RT4KCN4SGK9.gz
  • Enabled - Add a checkmark to enable the distribution and make it active.
Clouds > AWS Global > CloudFront > Show > Edit
You must to post a comment.
Last modified
08:46, 3 Jun 2013

Tags

This page has no custom tags.

Classifications

This page has no classifications.

Announcements

None


© 2006-2014 RightScale, Inc. All rights reserved.
RightScale is a registered trademark of RightScale, Inc. All other products and services may be trademarks or servicemarks of their respective owners.