Connecting an origin group to a resource
To connect an origin group to the resource, under Content, select Origin group when creating or updating resource settings.
Connecting an origin group when creating a resource
-
In the management console, select the folder where you want to create a resource.
-
Select Cloud CDN.
-
Click Create resource.
-
Under Content, select
From origin group
in the Content query field. -
Select an origin group.
-
Specify the other resource settings. For more information, see Creating a resource.
-
Click Create.
If you don't have the Yandex Cloud command line interface yet, install and initialize it.
The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name
or --folder-id
parameter.
-
View a description of the CLI create resource command:
yc cdn resource create --help
-
Get a list of all origin groups in the default folder:
yc cdn origin-group list --format yaml
Result:
- id: "90209" folder_id: b1g86q4m5vej8lkljme5 name: test-group-1 use_next: true origins: - id: "561547" origin_group_id: "90209" source: www.example2.com enabled: true backup: true - id: "561546" origin_group_id: "90209" source: www.example1.com enabled: true - id: "90208" folder_id: b1g86q4m5vej8lkljme5 name: test-group use_next: true origins: - id: "561545" origin_group_id: "90208" source: www.a2.com enabled: true backup: true - id: "561544" origin_group_id: "90208" source: www.a1.com enabled: true
-
Create a resource with the connected origin group:
yc cdn resource create --cname <resource domain name> \ --origin-group-id <origin group ID> \ --origin-protocol https
Where:
origin-group-id
: Origin group ID.origin-protocol
: Origin protocol.
Result:
id: bc855oumelrqw3ceywih folder_id: b1g86q4m5vej8lkljme5 cname: res1.example.com created_at: "2022-01-15T15:13:42.827643Z" updated_at: "2022-01-15T15:13:42.827671Z" active: true options: edge_cache_settings: enabled: true default_value: "345600" cache_http_headers: value: - accept-ranges - cache-control - connection - content-encoding - content-length - content-type - date - etag - expires - keep-alive - last-modified - server - vary stale: enabled: true value: - error - updating allowed_http_methods: value: - GET - POST - HEAD - OPTIONS origin_group_id: "90208" origin_group_name: test-group-22 origin_protocol: HTTPS ssl_certificate: type: DONT_USE status: READY
For more information about the
yc cdn resource create
command, see the CLI reference.
If you don't have Terraform, install it and configure the Yandex Cloud provider.
-
Describe the resource parameters in the
yandex_cdn_resource
configuration file.Example configuration file structure:
provider "yandex" { token = "<OAuth>" cloud_id = "<cloud ID>" folder_id = "<folder ID>" zone = "<default availability zone>" } resource "yandex_cdn_resource" "my_resource" { cname = "<resource domain name>" active = true origin_protocol = "https" origin_group_id = <origin group ID> }
For more information about the resources you can create using Terraform, see the provider documentation.
-
Make sure the settings are correct.
-
Using the command line, navigate to the folder that contains the up-to-date Terraform configuration files with an infrastructure plan.
-
Run the command:
terraform validate
If there are errors in the configuration files, Terraform will point to them.
-
-
Create an origin group.
-
Run the command to view planned changes:
terraform plan
If the resource configuration descriptions are correct, the terminal will display a list of the resources to modify and their parameters. This is a test step. No resources are updated.
-
If you are happy with the planned changes, apply them:
-
Run the command:
terraform apply
-
Confirm the update of resources.
-
Wait for the operation to complete.
-
-
Connecting an origin group when editing resource settings
-
In the management console, select the folder where you a resource is located.
-
Select Cloud CDN.
-
Click the name of the desired resource.
-
In the top right-hand corner, click Edit.
-
Select an origin group.
-
Enter the other resource settings if needed. For more information, see Editing the basic settings of a resource.
-
Click Save.
If you don't have the Yandex Cloud command line interface yet, install and initialize it.
The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name
or --folder-id
parameter.
-
View a description of the CLI update resource command:
yc cdn resource update --help
-
Get a list of all resources in the default folder:
yc cdn resource list --format yaml
Result:
- id: bc82xll34xuc4kymnpqq folder_id: b1g86q4m5vej8lkljme5 cname: res1.example.com created_at: "2022-01-21T08:17:48.850086Z" updated_at: "2022-01-21T08:17:48.850125Z" active: true options: edge_cache_settings: enabled: true default_value: "345600" cache_http_headers: value: - accept-ranges - cache-control - connection - content-encoding - content-length - content-type - date - etag - expires - keep-alive - last-modified - server - vary stale: enabled: true value: - error - updating allowed_http_methods: value: - GET - POST - HEAD - OPTIONS origin_group_id: "90208" origin_group_name: test-group origin_protocol: HTTPS ssl_certificate: type: DONT_USE status: READY
-
Get a list of all origin groups in the default folder and select the
ID
of the appropriate group:yc cdn origin-group list --format yaml
Result:
- id: "90209" folder_id: b1g86q4m5vej8lkljme5 name: test-group-1 use_next: true origins: - id: "561547" origin_group_id: "90209" source: www.example2.com enabled: true backup: true - id: "561546" origin_group_id: "90209" source: www.example1.com enabled: true - id: "90208" folder_id: b1g86q4m5vej8lkljme5 name: test-group use_next: true origins: - id: "561545" origin_group_id: "90208" source: www.a2.com enabled: true backup: true - id: "561544" origin_group_id: "90208" source: www.a1.com enabled: true
-
Update resource settings by specifying the ID of the appropriate origin group:
yc cdn resource update --id <resource ID> \ --origin-group-id <origin group ID>
Result:
id: bc8krsk72icwnvyvs6c3 folder_id: b1g86q4m5vej8lkljme5 cname: res2.example.com created_at: "2022-01-15T15:29:19.103653Z" updated_at: "2022-01-15T15:33:22.819916Z" active: true options: edge_cache_settings: enabled: true default_value: "345600" cache_http_headers: value: - accept-ranges - cache-control - connection - content-encoding - content-length - content-type - date - etag - expires - keep-alive - last-modified - server - vary stale: enabled: true value: - error - updating allowed_http_methods: value: - GET - POST - HEAD - OPTIONS origin_group_id: "90209" origin_group_name: test-group-1 origin_protocol: HTTPS ssl_certificate: type: DONT_USE status: READY
For more information about the
yc cdn resource update
command, see the CLI reference.
It may take up to 15 minutes for the new resource settings to apply to CDN servers. After that, we recommend purging the resource cache.