Смонтировать бакеты в контейнер

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

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

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

yc serverless container revision deploy \
  --container-name <имя_контейнера> \
  --image <URL_Docker-образа> \
  --memory <объем_RAM> \
  --execution-timeout <максимальное_время_выполнения> \
  --service-account-id <идентификатор_сервисного_аккаунта> \
  --command '<команда_1>','<команда_2>' \
  --args '<ключ_1=значение_1>','<ключ_2=значение_2>' \
  --mount type=object-storage,mount-point=<путь_монтирования>,bucket=<имя_бакета>,prefix=<имя_папки>,mode=<режим_монтирования>

Где:

• --container-name — имя контейнера.

• --image — URL Docker-образа, из которого вы создаете ревизию контейнера, в формате: cr.yandex/<идентификатор_реестра>/<имя_Docker-образа>:<тег>.

• --memory — необходимый объем RAM.

• --execution-timeout — максимальное время выполнения контейнера до таймаута.

• --service-account-id — идентификатор сервисного аккаунта. Для чтения данных из бакета сервисному аккаунту необходима роль storage.viewer, для чтения и записи — роль storage.uploader.

• --command — команды, которые контейнер выполнит при запуске. Указываются через запятую. Соответствует инструкции ENTRYPOINT в Dockerfile.

• --args — аргументы, соответствует инструкции CMD в Dockerfile. Указываются в формате ключ = значение через запятую. Если не указано, будет использоваться значение CMD по умолчанию из Docker-образа.

• --mount — параметры монтирования бакета Object Storage:

  • type — тип монтируемого хранилища. Для бакета значение всегда object-storage.
  • mount-point — абсолютный путь монтирования. Директория, к которой смонтируется бакет, будет доступна по заданному пути.
  • bucket — имя бакета.
  • prefix — папка в бакете, которая будет смонтирована в контейнер. Если поле не задано или пустое, смонтируется весь бакет.
  • mode — режим монтирования бакета: ro — только чтение, rw — чтение и запись.

  Чтобы смонтировать в контейнер одновременно несколько бакетов, задайте параметр --mount необходимое количество раз.

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

1. Откройте файл конфигурации Terraform и добавьте к описанию контейнера блок mounts:

   resource "yandex_serverless_container" "test-container" {
     ...
   
     mounts {
       mount_point_path = "<точка_монтирования>"
       mode             = "<режим_монтирования>"
       object_storage {
         bucket = "<имя_бакета>"
         prefix = "<имя_папки>"
       }
     }
   }
   

   Где:

   • mounts — параметры монтирования бакета Object Storage:

     • mount_point_path — абсолютный путь монтирования. Директория, к которой смонтируется бакет, будет доступна по указанному пути.
     • mode — режим монтирования бакета: ro — только чтение, rw — чтение и запись.
     • object_storage — параметры бакета:
       • bucket — имя бакета.
       • prefix — папка в бакете, которая будет смонтирована в контейнер. Если поле пустое, смонтируется весь бакет.

     Чтобы смонтировать в контейнер одновременно несколько бакетов, задайте блок mounts необходимое количество раз.

   Более подробную информацию о параметрах ресурса yandex_serverless_container см. в документации провайдера.

2. Примените изменения:

   1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.

   2. Проверьте корректность конфигурационного файла с помощью команды:

      terraform validate
      

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.
      

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

      terraform plan
      

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

   4. Примените изменения конфигурации:

      terraform apply
      

   5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

Проверить изменение ревизии контейнера и ее настройки можно в консоли управления или с помощью команды CLI:

yc serverless container revision get <идентификатор_ревизии_контейнера>

Воспользуйтесь методом REST API deployRevision для ресурса Container или вызовом gRPC API ContainerService/DeployRevision.