Интеграция L7-балансировщика с Cloud CDN и Object Storage с помощью консоли управления

1. Создайте сеть example-network:

   yc vpc network create example-network
   

   Результат:

     id: enpqm699f18v********
     folder_id: b1gt6g8ht345********
     created_at: "2026-02-05T11:57:02Z"
     name: example-network
     default_security_group_id: enp4qvbg2ri1********
   

   Подробнее о команде yc vpc network create читайте в справочнике CLI.

2. Создайте подсети во всех зонах доступности:

   • В ru-central1-a:

     yc vpc subnet create example-subnet-ru-central1-a \
       --zone ru-central1-a \
       --network-name example-network \
       --range 192.168.1.0/24
     

     Результат:

     id: e9b0fo0hvhpd********
     folder_id: b1gt6g8ht345********
     created_at: "2026-02-05T12:00:21Z"
     name: example-subnet-ru-central1-a
     network_id: enpqm699f18v********
     zone_id: ru-central1-a
     v4_cidr_blocks:
       - 192.168.1.0/24
     

     Сохраните полученный идентификатор подсети — он понадобится позднее при создании L7-балансировщика.

   • В ru-central1-b:

     yc vpc subnet create example-subnet-ru-central1-b \
       --zone ru-central1-b \
       --network-name example-network \
       --range 192.168.2.0/24
     

     Результат:

     id: e2lo05oe9slo********
     folder_id: b1gt6g8ht345********
     created_at: "2026-02-05T12:02:02Z"
     name: example-subnet-ru-central1-b
     network_id: enpqm699f18v********
     zone_id: ru-central1-b
     v4_cidr_blocks:
       - 192.168.2.0/24
     

     Сохраните полученный идентификатор подсети — он понадобится позднее при создании L7-балансировщика.

   • В ru-central1-d:

     yc vpc subnet create example-subnet-ru-central1-d \
       --zone ru-central1-d \
       --network-name example-network \
       --range 192.168.3.0/24
     

     Результат:

     id: fl8bpb6lnu80********
     folder_id: b1gt6g8ht345********
     created_at: "2026-02-05T12:03:23Z"
     name: example-subnet-ru-central1-d
     network_id: enpqm699f18v********
     zone_id: ru-central1-d
     v4_cidr_blocks:
       - 192.168.3.0/24
     

     Сохраните полученный идентификатор подсети — он понадобится позднее при создании L7-балансировщика.

   Подробнее о команде yc vpc subnet create читайте в справочнике CLI.

1. Чтобы создать сеть example-network, воспользуйтесь методом REST API create для ресурса Network или вызовом gRPC API NetworkService/Create.
2. Чтобы создать подсети example-subnet-ru-central1-a, example-subnet-ru-central1-b и example-subnet-ru-central1-d в трех зонах доступности, воспользуйтесь методом REST API create для ресурса Subnet или вызовом gRPC API SubnetService/Create.

Выполните команду:

yc vpc security-group create example-sg \
  --network-name example-network \
  --rule "direction=egress,port=any,protocol=any,v4-cidrs=[0.0.0.0/0]" \
  --rule "direction=ingress,port=80,protocol=tcp,v4-cidrs=[0.0.0.0/0]" \
  --rule "direction=ingress,port=443,protocol=tcp,v4-cidrs=[0.0.0.0/0]" \
  --rule "direction=ingress,port=30080,protocol=tcp,predefined=loadbalancer_healthchecks"

Результат:

id: enp9dpfa774h********
folder_id: b1gt6g8ht345********
created_at: "2026-02-05T12:29:47Z"
name: example-sg
network_id: enpqm699f18v********
status: ACTIVE
rules:
  - id: enpa11mk1r50********
    direction: EGRESS
    protocol_name: ANY
    protocol_number: "-1"
    cidr_blocks:
      v4_cidr_blocks:
        - 0.0.0.0/0
  - id: enp4aob2uiam********
    direction: INGRESS
    ports:
      from_port: "80"
      to_port: "80"
    protocol_name: TCP
    protocol_number: "6"
    cidr_blocks:
      v4_cidr_blocks:
        - 0.0.0.0/0
  - id: enpn8onb4lda********
    direction: INGRESS
    ports:
      from_port: "443"
      to_port: "443"
    protocol_name: TCP
    protocol_number: "6"
    cidr_blocks:
      v4_cidr_blocks:
        - 0.0.0.0/0
  - id: enp6j82kiu2p********
    direction: INGRESS
    ports:
      from_port: "30080"
      to_port: "30080"
    protocol_name: TCP
    protocol_number: "6"
    predefined_target: loadbalancer_healthchecks

Сохраните полученный идентификатор группы безопасности — он понадобится позднее при создании L7-балансировщика.

Подробнее о команде yc vpc security-group create читайте в справочнике CLI.

Воспользуйтесь методом REST API create для ресурса SecurityGroup или вызовом gRPC API SecurityGroupService/Create.

Чтобы добавить правило для проверок состояния балансировщика, используйте параметр loadbalancer_healthchecks в поле predefinedTarget для REST API или в поле SecurityGroupRuleSpec.target.predefined_target для gRPC API.

Выполните команду, указав уникальное имя бакета:

yc storage bucket create \
  --name <имя_бакета> \
  --public-read \
  --public-list

Результат:

name: my-cdn-bucket
folder_id: b1gt6g8ht345********
anonymous_access_flags:
  read: true
  list: true
default_storage_class: STANDARD
versioning: VERSIONING_DISABLED
created_at: "2026-02-05T12:35:03.639102Z"
resource_id: e3e8qar9vrim********

Воспользуйтесь методом REST API create для ресурса Bucket или вызовом gRPC API BucketService/Create.

Создать группу бэкендов с бэкендом типа бакет с помощью Yandex Cloud CLI в настоящий момент нельзя. Воспользуйтесь консолью управления или API, чтобы создать нужную группу бэкендов.

Воспользуйтесь методом REST API create для ресурса BackendGroup или вызовом gRPC API BackendGroupService/Create.

1. Создайте HTTP-роутер example-router:

   yc alb http-router create example-router
   

   Результат:

   id: ds78i77j8lg0********
   name: example-router
   folder_id: b1gt6g8ht345********
   created_at: "2026-02-05T13:09:27.917359782Z"
   

   Подробнее о команде yc alb http-router create читайте в справочнике CLI.

2. Создайте виртуальный хост example-vh:

   yc alb virtual-host create example-vh \
     --http-router-name example-router \
     --authority <имя_домена>
   

   Где <имя_домена> — имя вашего домена. Например: example.com.

   Результат:

   done (1s)
   name: example-vh
   authority:
     - example.com
   

   Подробнее о команде yc alb virtual-host create читайте в справочнике CLI.

3. Создайте маршрут example-route в виртуальном хосте example-vh:

   yc alb virtual-host append-http-route example-route \
     --http-router-name example-router \
     --virtual-host-name example-vh \
     --prefix-path-match "/" \
     --backend-group-name example-bg
   

   Результат:

   done (1s)
   name: example-vh
   authority:
     - example.com
   routes:
     - name: example-route
       http:
         match:
           path:
             prefix_match: /
         route:
           backend_group_id: ds7glpil29lb********
   

   Подробнее о команде yc alb virtual-host append-http-route читайте в справочнике CLI.

1. Чтобы создать HTTP-роутер example-router, воспользуйтесь методом REST API create для ресурса HttpRouter или вызовом gRPC API HttpRouterService/Create.
2. Чтобы создать виртуальный хост example-vh, привязанный к роутеру, и его маршрут, воспользуйтесь методом REST API create для ресурса VirtualHost или вызовом gRPC API VirtualHostService/Create.

1. Создайте балансировщик example-balancer:

   yc alb load-balancer create example-balancer \
     --network-name example-network \
     --security-group-id <идентификатор_группы_безопасности_example-sg> \
     --location zone=ru-central1-a,subnet-id=<идентификатор_подсети_example-subnet-ru-central1-a> \
     --location zone=ru-central1-b,subnet-id=<идентификатор_подсети_example-subnet-ru-central1-b> \
     --location zone=ru-central1-d,subnet-id=<идентификатор_подсети_example-subnet-ru-central1-d>
   

   Где:

   • --security-group-id — идентификатор группы безопасности, сохраненный ранее при ее создании.
   • subnet-id — идентификаторы подсетей в трех зонах доступности, сохраненные ранее при их создании.

   Результат:

   done (7m17s)
   id: ds790ardig7r********
   name: example-balancer
   folder_id: b1gt6g8ht345********
   status: ACTIVE
   region_id: ru-central1
   network_id: enpqm699f18v********
   allocation_policy:
     locations:
       - zone_id: ru-central1-a
         subnet_id: e9b0fo0hvhpd********
       - zone_id: ru-central1-b
         subnet_id: e2lo05oe9slo********
       - zone_id: ru-central1-d
         subnet_id: fl8bpb6lnu80********
   security_group_ids:
     - enp9dpfa774h********
   created_at: "2026-02-05T13:30:25.695763710Z"
   

   Подробнее о команде yc alb load-balancer create читайте в справочнике CLI.

2. Добавьте к балансировщику обработчик:

   yc alb load-balancer add-listener \
     --name example-balancer \
     --listener-name example-listener \
     --external-ipv4-endpoint port=80 \
     --http-router-name example-router
   

   Результат:

   done (9m53s)
   id: ds790ardig7r********
   name: example-balancer
   folder_id: b1gt6g8ht345********
   status: ACTIVE
   region_id: ru-central1
   network_id: enpqm699f18v********
   listeners:
     - name: example-listener
       endpoints:
         - addresses:
             - external_ipv4_address:
                 address: 158.160.***.***
           ports:
             - "80"
       http:
         handler:
           http_router_id: ds78i77j8lg0********
   allocation_policy:
     locations:
       - zone_id: ru-central1-a
         subnet_id: e9b0fo0hvhpd********
       - zone_id: ru-central1-b
         subnet_id: e2lo05oe9slo********
       - zone_id: ru-central1-d
         subnet_id: fl8bpb6lnu80********
   security_group_ids:
     - enp9dpfa774h********
   

   Сохраните IP-адрес обработчика (значение поля address) — он понадобится позднее при создании CDN-ресурса.

   Подробнее о команде yc alb load-balancer add-listener читайте в справочнике CLI.

Чтобы создать L7-балансировщик, воспользуйтесь методом REST API create для ресурса LoadBalancer или вызовом gRPC API LoadBalancerService/Create.

1. Создайте группу источников example-origin-group, указав сохраненный ранее IP-адрес балансировщика:

   yc cdn origin-group create --name "example-origin-group" \
     --origin source=<IP-адрес_балансировщика>:80,enabled=true
   

   Результат:

   id: "12756795849********"
   folder_id: b1gt6g8ht345********
   name: example-origin-group
   use_next: true
   origins:
     - id: "68784"
       origin_group_id: "12756795849********"
       source: 158.160.***.***:80
       enabled: true
       provider_type: ourcdn
   provider_type: ourcdn
   

   Сохраните идентификатор группы источников (значение поля origin_group_id) — он понадобится позднее при создании CDN-ресурса.

   Подробнее о команде yc cdn origin-group create читайте в справочнике CLI.

2. Создайте CDN-ресурс:

   yc cdn resource create \
     --cname <имя_домена> \
     --origin-group-id <идентификатор_группы_источников> \
     --origin-protocol http \
     --cert-manager-ssl-cert-id <идентификатор_сертификата> \
     --forward-host-header
   

   Где:

   • --cname — имя вашего домена. Например: example.com.
   • --origin-group-id — идентификатор группы источников, полученный на предыдущем шаге.
   • --cert-manager-ssl-cert-id — идентификатор созданного ранее сертификата mymanagedcert.

   Результат:

   id: bc8rpt67l6dl********
   folder_id: b1gt6g8ht345********
   cname: example.com
   created_at: "2026-02-05T14:05:24.913996Z"
   updated_at: "2026-02-05T14:05:24.913996Z"
   active: true
   options:
     edge_cache_settings:
       enabled: true
       default_value: "86400"
     browser_cache_settings: {}
     query_params_options:
       ignore_query_string:
         enabled: true
         value: true
     slice: {}
     host_options:
       forward_host_header:
         enabled: true
         value: true
     static_headers:
       enabled: true
     stale: {}
     allowed_http_methods:
       enabled: true
       value:
         - GET
         - HEAD
         - OPTIONS
     static_request_headers:
       enabled: true
     custom_server_name: {}
     ignore_cookie:
       enabled: true
       value: true
     secure_key:
       type: DISABLE_IP_SIGNING
   origin_group_id: "12756795849********"
   origin_group_name: example-origin-group
   origin_protocol: HTTP
   ssl_certificate:
     type: CM
     status: READY
     data:
       cm:
         id: fpq7t9dpi4o0********
   provider_type: ourcdn
   provider_cname: d88c6ee6********.topology.gslb.yccdn.ru
   

   Сохраните идентификатор созданного ресурса (значение поля id), а также значение CNAME провайдера (значение поля provider_cname) — они понадобятся позднее.

   Подробнее о команде yc cdn resource create читайте в справочнике CLI.

3. Включите переадресацию клиентов для CDN-ресурса, указав сохраненный на предыдущем шаге идентификатор:

   yc cdn resource update <идентификатор_CDN-ресурса> \
     --redirect-http-to-https
   

   Подробнее о команде yc cdn resource update читайте в справочнике CLI.

Чтобы создать CDN-ресурс, воспользуйтесь методом REST API create для ресурса Resource или вызовом gRPC API ResourceService/Create.

1. Создайте ресурсную запись CNAME в сервисе Cloud DNS:

   yc dns zone add-records \
     --name my-domain-zone \
     --record "@ 600 CNAME <значение_cname>"
   

   Где <значение_cname> — полученное ранее значение CNAME провайдера.

   Результат:

   +--------+--------------+-------+-----------------------------------------+-----+
   | ACTION |     NAME     | TYPE  |                  DATA                   | TTL |
   +--------+--------------+-------+-----------------------------------------+-----+
   | +      | example.com. | CNAME | d88c6ee6********.topology.gslb.yccdn.ru | 600 |
   +--------+--------------+-------+-----------------------------------------+-----+
   

   Подробнее о команде yc dns zone add-records читайте в справочнике CLI.

Чтобы получить значение CNAME-записи для CDN-ресурса, воспользуйтесь методом REST API getProviderCName для ресурса Resource или вызовом gRPC API ResourceService/GetProviderCName.

Чтобы создать ресурсную запись CNAME в зоне DNS, воспользуйтесь методом REST API updateRecordSets для ресурса DnsZone или вызовом gRPC API DnsZoneService/UpdateRecordSets.