Getting started with Yandex Cloud CDN

Configure content sharing via a CDN using a Object Storage bucket as an example:

1. Create a CDN resource
2. Upload your content to the CDN
3. Set up a CNAME record for your domain
4. Test the CDN

Getting startedGetting started

1. Make sure you have a domain name and can access the DNS settings on the website of your DNS hosting provider. This is usually the company that registered your domain.

2. Go to the management console and log in to Yandex Cloud or create an account if you do not have one yet.

3. If you do not have a folder yet, create one:

   1. In the management console, select the appropriate cloud in the list on the left.

   2. At the top right, click Create folder.

   3. Enter the folder name. The naming requirements are as follows:

      • The name must be from 3 to 63 characters long.
      • It may contain lowercase Latin letters, numbers, and hyphens.
      • The first character must be a letter and the last character cannot be a hyphen.

   4. (Optional) Enter a description of the folder.

   5. Select Create a default network. This will create a network with subnets in each availability zone. Within this network, a default security group will be created, inside which all network traffic is allowed.

   6. Click Create.

4. Go to the folder page and select Cloud CDN.

5. If the CDN provider is not activated yet, click Activate provider. A connection will be established automatically.

   If you do not see the Activate provider button and you can create resources and origin groups, it means that the provider is already activated. Proceed to the next step.

6. If you do not have a Object Storage bucket yet:

   1. Create a bucket.
   2. Enable public access to the objects in the bucket and the object list.
   3. Upload content to the bucket.

Create a CDN resourceCreate a CDN resource

1. Go to the folder page and select Cloud CDN.

2. In the CDN resources tab, click Create resource.

3. Configure your CDN resource as follows:

   • Content query: Select From one origin.

   • Origin type: Select Bucket.

   • Bucket: Select the bucket created in Object Storage.

   • Domain names for content distribution: Specify the primary domain name that you will use in your website links to content posted on the CDN, e.g., cdn.example.com.

     Alert

     You cannot change the primary domain name used for content distribution after creating a CDN resource.

   • Under Additional:

     1. In the Origin request protocol field, select HTTP.

     2. In the Host header field, select Custom.

     3. In the Header value field, specify the domain name from the bucket URL in <bucket_name>storage.yandexcloud.net format. The schema (http or https) does not need to be specified. Here is an example:

        my-bucket.storage.yandexcloud.net
        

        Alert

        If an incorrect Host header is configured, Object Storage will return errors in response to CDN server requests.

4. Click Create.

Upload your content to the CDNUpload your content to the CDN

To preload content to CDN servers:

1. Go to the Content tab.

2. Click Preload content.

3. In the File path field, enter the names of the files stored in the bucket, omitting the bucket name, e.g.:

   /index.html
   /static/styles.css
   /static/app.js
   

4. Click Preload content.

Set up a CNAME record for your domainSet up a CNAME record for your domain

1. In the Overview tab, under DNS settings, copy the URL generated on the .edgecdn.ru domain to the clipboard.

2. Go to your domain's DNS settings on the site of your DNS hosting provider.

3. Edit the appropriate CNAME record so that it points to the previously copied URL on the .edgecdn.ru domain. For example, if the domain name you specified when creating your CDN resource is cdn.example.com, you need to create or replace an existing record for cdn with the following CNAME record:

   cdn CNAME cl-********.edgecdn.ru.
   

   Note

   Do not use an ANAME resource record with domain names for content distribution; otherwise, the end user will get a response from a CDN server not linked to the user's geolocation. The response will always be the same for all users.

Test the CDNTest the CDN

1. Wait until the DNS records are updated. This might take a few hours.

2. Make sure that the cdn CNAME record in the DNS server's cache points to the URL generated by the service (e.g., cl-********.edgecdn.ru).

3. Try opening the site's URL in the browser, for example:

   http://cdn.example.com/index.html