Автоматическая привязка политики резервного копирования Yandex Cloud Backup к ВМ с помощью консоли управления, CLI или API

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Посмотрите описание команды CLI для активации сервиса:

   yc backup provider activate --help
   

2. Активируйте сервис в каталоге по умолчанию:

   yc backup provider activate --async
   

   Где --async — отображение информации о прогрессе операции. Необязательный параметр.

3. После выполнения команды появится предупреждение об активации This command will activate backup provider for your folder. Do you confirm this action to be executed? [Yes/no][y/N]. Подтвердите активацию — в терминале введите yes или y.

   Совет

   Чтобы активировать сервис без подтверждения, используйте флаг --force.

   Результат:

   id: cdgmnefxiatx********
   description: activate provider
   created_at: "2024-10-14T09:03:47.960564Z"
   created_by: ajec1gaqcmtr********
   modified_at: "2024-10-14T09:03:47.960564Z"
   done: true
   metadata:
     '@type': type.googleapis.com/yandex.cloud.backup.v1.ActivateProviderMetadata
     folder_id: b1go3el0d8fs********
   response:
     '@type': type.googleapis.com/google.protobuf.Empty
     value: {}
   

После активации автоматически создаются следующие политики резервного копирования:

• Default daily — ежедневное создание инкрементальной копии с сохранением последних 15 копий.
• Default weekly — еженедельное создание инкрементальной копии с сохранением последних 15 копий.
• Default monthly — ежемесячное создание инкрементальной копии с сохранением последних 15 копий.

Если вы не хотите их создавать, используйте параметр --skip-default-policy.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Создайте сервисный аккаунт с именем backup-sa:

   yc iam service-account create --name backup-sa
   

   Результат:

   id: ajehb3tcdfa1********
   folder_id: b1g86q4m5vej********
   created_at: "2024-07-22T16:05:14.237381531Z"
   name: backup-sa
   

   Подробнее о команде yc iam service-account create см. в справочнике CLI.

2. Назначьте сервисному аккаунту роль backup.editor на каталог:

   yc resource-manager folder add-access-binding <идентификатор_каталога> \
     --role backup.editor \
     --subject serviceAccount:<идентификатор_сервисного_аккаунта>
   

   Результат:

   done (3s)
   effective_deltas:
     - action: ADD
       access_binding:
         role_id: backup.editor
         subject:
           id: ajehb3tcdfa1********
           type: serviceAccount
   

   Подробнее о команде yc resource-manager folder add-access-binding см. в справочнике CLI.

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

Чтобы назначить сервисному аккаунту роль backup.editor на каталог, воспользуйтесь методом setAccessBindings для ресурса ServiceAccount или вызовом gRPC API ServiceAccountService/SetAccessBindings.

1. Создайте облачную сеть с именем cloud-network:

   yc vpc network create cloud-network
   

   Результат:

   id: enptrcle5q3d********
   folder_id: b1g9hv2loamq********
   created_at: "2024-06-08T09:25:03Z"
   name: cloud-network
   default_security_group_id: enpbsnnop4ak********
   

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

2. Создайте подсеть cloud-network-kz1-d в зоне доступности kz1-d:

   yc vpc subnet create cloud-network-kz1-d \
     --zone kz1-d \
     --network-name cloud-network \
     --range 10.1.0.0/16
   

   Результат:

   id: e9bnnssj8sc8********
   folder_id: b1g9hv2loamq********
   created_at: "2024-06-08T09:27:00Z"
   name: cloud-network-kz1-d
   network_id: enptrcle5q3d********
   zone_id: kz1-d
   v4_cidr_blocks:
   - 10.1.0.0/16
   

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

1. Создайте сеть cloud-network с помощью метода REST API create для ресурса Network или вызова gRPC API NetworkService/Create.
2. Создайте подсеть cloud-network-kz1-d с помощью метода REST API create для ресурса Subnet или вызова gRPC API SubnetService/Create.

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

yc vpc security-group create backup-sg \
  --network-name network-1 \
  --rule "direction=egress,port=80,protocol=tcp,v4-cidrs=[213.180.193.0/24]" \
  --rule "direction=egress,port=80,protocol=tcp,v4-cidrs=[213.180.204.0/24]" \
  --rule "direction=egress,port=443,protocol=tcp,v4-cidrs=[84.47.172.0/24]" \
  --rule "direction=egress,port=443,protocol=tcp,v4-cidrs=[84.201.181.0/24]" \
  --rule "direction=egress,port=443,protocol=tcp,v4-cidrs=[178.176.128.0/24]" \
  --rule "direction=egress,port=443,protocol=tcp,v4-cidrs=[213.180.193.0/24]" \
  --rule "direction=egress,port=443,protocol=tcp,v4-cidrs=[213.180.204.0/24]" \
  --rule "direction=egress,from-port=7770,to-port=7800,protocol=tcp,v4-cidrs=[84.47.172.0/24]" \
  --rule "direction=egress,port=8443,protocol=tcp,v4-cidrs=[84.47.172.0/24]" \
  --rule "direction=egress,port=44445,protocol=tcp,v4-cidrs=[51.250.1.0/24]" \
  --rule "direction=ingress,port=22,protocol=any,v4-cidrs=[0.0.0.0/0]"

Результат:

id: enp0v73fe8fs********
folder_id: b1g86q4m5vej********
created_at: "2024-07-22T20:17:43Z"
name: backup-sgg
network_id: enp3srbi9u49********
status: ACTIVE
rules:
- id: enpporsovuhj********
    direction: EGRESS
    ports:
      from_port: "80"
      to_port: "80"
    protocol_name: TCP
    protocol_number: "6"
    cidr_blocks:
      v4_cidr_blocks:
        - 213.180.193.0/24
- id: enp7p6asol5i********
    direction: EGRESS
    ports:
      from_port: "80"
      to_port: "80"
    protocol_name: TCP
    protocol_number: "6"
    cidr_blocks:
      v4_cidr_blocks:
        - 213.180.204.0/24
...
- id: enp36mip5nhe********
    direction: INGRESS
    ports:
      from_port: "22"
      to_port: "22"
    protocol_name: ANY
    protocol_number: "-1"
    cidr_blocks:
      v4_cidr_blocks:
        - 0.0.0.0/0

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

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

1. Опишите конфигурацию создаваемой политики резервного копирования в файле backup-policy-scheme.json.

   {
     "compression": "NORMAL",
     "format": "AUTO",
     "multiVolumeSnapshottingEnabled": true,
     "preserveFileSecuritySettings": true,
     "reattempts": {
       "enabled": true,
       "interval": {
         "type": "SECONDS",
         "count": "30"
       },
       "maxAttempts": "30"
     },
     "silentModeEnabled": true,
     "splitting": {
       "size": "1099511627776"
     },
     "vmSnapshotReattempts": {
       "enabled": true,
       "interval": {
         "type": "MINUTES",
         "count": "5"
       },
       "maxAttempts": "3"
     },
     "vss": {
       "enabled": true,
       "provider": "TARGET_SYSTEM_DEFINED"
     },
     "archive": {
       "name": "'[Machine Name]-[Plan ID]-[Unique ID]A'"
     },
     "performanceWindow": {
       "enabled": true
     },
     "scheduling": {
       "backupSets": [
         {
           "time": {
             "weekdays": [
               "FRIDAY"
             ],
             "repeatAt": [
               {
                 "hour": "3"
               }
             ],
             "type": "WEEKLY"
           }
         }
       ],
       "enabled": true,
       "maxParallelBackups": "2",
       "randMaxDelay": {
         "type": "MINUTES",
         "count": "30"
       },
       "scheme": "ALWAYS_INCREMENTAL",
       "weeklyBackupDay": "MONDAY"
     },
     "cbt": "ENABLE_AND_USE",
     "fastBackupEnabled": true,
     "quiesceSnapshottingEnabled": true
   }
   

2. Создайте политику резервного копирования:

   yc backup policy create \
     --name weekly-backup \
     --settings-from-file ./backup-policy-scheme.json
   

   Результат:

   id: cdgo5vytuw57********
   name: weekly-backup
   created_at: "2024-07-23T20:34:37Z"
   updated_at: "2024-07-23T20:34:37Z"
   enabled: true
   settings:
     compression: NORMAL
     format: AUTO
     multi_volume_snapshotting_enabled: true
     preserve_file_security_settings: true
     reattempts:
       enabled: true
       interval:
         type: SECONDS
         count: "30"
       max_attempts: "30"
     silent_mode_enabled: true
     splitting:
       size: "1099511627776"
     vm_snapshot_reattempts:
       enabled: true
       interval:
         type: MINUTES
         count: "5"
       max_attempts: "3"
     vss:
       enabled: true
       provider: TARGET_SYSTEM_DEFINED
     archive:
       name: '''[Machine Name]-[Plan ID]-[Unique ID]A'''
     performance_window:
       enabled: true
     retention: {}
     scheduling:
       backup_sets:
         - time:
             weekdays:
               - FRIDAY
             repeat_at:
               - hour: "3"
             type: WEEKLY
           type: TYPE_AUTO
       enabled: true
       max_parallel_backups: "2"
       rand_max_delay:
         type: MINUTES
         count: "30"
       scheme: ALWAYS_INCREMENTAL
       weekly_backup_day: MONDAY
     cbt: ENABLE_AND_USE
     fast_backup_enabled: true
     quiesce_snapshotting_enabled: true
   folder_id: b1g86q4m5vej********
   

   Сохраните идентификатор (id) политики.

   Подробнее о команде yc backup policy create см. в справочнике CLI.

Чтобы создать политику резервного копирования, воспользуйтесь методом REST API create для ресурса Policy или вызовом gRPC API PolicyService/Create.

1. Опишите конфигурацию пользовательских метаданных в файле user-data.yaml:

   #cloud-config
   datasource:
     Ec2:
     strict_id: false
   ssh_pwauth: no
   users:
   - name: vm-user
     sudo: ALL=(ALL) NOPASSWD:ALL
     shell: /bin/bash
     ssh_authorized_keys:
     - <публичный_SSH-ключ>
   packages:
     - curl
     - perl
     - jq
   runcmd:
     - curl https://storage.yandexcloud.kz/backup-distributions/agent_installer.sh | sudo bash
   

2. Сохраните идентификатор политики weekly-backup в файле cloudbackup.json:

   {"initialPolicies": ["<идентификатор_политики_weekly-backup>"]}
   

   Подробности о получении идентификатора политики см. на странице Получить информацию о политике резервного копирования.

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

   yc compute instance create \
     --name backup-instance \
     --zone kz1-d \
     --network-interface subnet-name=cloud-network-kz1-d,security-group-ids=<идентификатор_группы_безопасности_backup-sg>,ipv4-address=auto,nat-ip-version=ipv4 \
     --create-boot-disk image-folder-id=standard-images,image-family=ubuntu-2204-lts,size=15 \
     --metadata-from-file user-data=./user-data.yaml,cloudbackup=./cloudbackup.json \
     --service-account-name backup-sa
   

   Подробнее о команде yc compute instance create см. в справочнике CLI.

Чтобы создать ВМ, воспользуйтесь методом REST API create для ресурса Instance или вызовом gRPC API InstanceService/Create.

В теле запроса передайте:

• в поле metadata: объект user-data, содержащий конфигурацию пользовательских метаданных со скриптом для установки агента Cloud Backup;
• в поле cloudbackup: идентификатор политики резервного копирования. Подробности о получении идентификатора политики см. на странице Получить информацию о политике резервного копирования.

Используйте \n в качестве разделителя строк:

{
  "folderId": "<идентификатор_каталога>",
  "name": "backup-instance",
  "zoneId": "kz1-d",
  "platformId": "standard-v3",
  "resourcesSpec": {
    "memory": "2147483648",
    "cores": "2"
  },
  "metadata": {
    "user-data": "#cloud-config\ndatasource:\nEc2:\n  strict_id: false\nssh_pwauth: no\nusers:\n- name: vm-user\n  shell: /bin/bash\n  sudo: ALL=(ALL) NOPASSWD:ALL\n  ssh_authorized_keys:\n  - <публичный_SSH-ключ>\npackages:\n  - curl\n  - perl\n  - jq\nruncmd:\n  - curl https://storage.yandexcloud.kz/backup-distributions/agent_installer.sh | sudo bash",
    "cloudbackup": "{\"initialPolicies\": [\"<идентификатор_политики>\"]}"
  },
  "bootDiskSpec": {
    "diskSpec": {
      "size": "16106127360",
      "imageId": "fd8ljvsrm3l1********"
    }
  },
  "networkInterfaceSpecs": [
    {
      "subnetId": "<идентификатор_подсети>",
      "primaryV4AddressSpec": {
        "oneToOneNatSpec": {
          "ipVersion": "IPV4"
        }
      },
      "securityGroupIds": [
        "<идентификатор_группы_безопасности>"
      ]
    }
  ],
  "serviceAccountId": "<идентификатор_сервисного_аккаунта>"
}