# VBoxManage cloud

VBoxManage-cloud

1 &product-name;

VBoxManage-cloud

Управление облачными сущностями

&product-name;

          VBoxManage cloud
            --provider=имя
            --profile=имя

            list
            instances
            --state=строка
            --compartment-id=строка

          VBoxManage cloud
          --provider=имя
          --profile=имя

          list
          images
          --compartment-id=строка
          --state=строка

           VBoxManage cloud
           --provider=имя
           --profile=имя

           instance
           create
           --domain-name=имя

               --image-id=id
               --boot-volume-id=id

           --display-name=имя
           --shape=тип
           --subnet=id
           --boot-disk-size=размер в ГБ
           --publicip=true/false
           --privateip=IP адрес
           --public-ssh-key=ключевая строка
           --launch-mode=NATIVE/EMULATED/PARAVIRTUALIZED
           --cloud-init-script-path=путь к скрипту

           VBoxManage cloud
           --provider=имя
           --profile=имя

           instance
           info
           --id=уникальный id

           VBoxManage cloud
           --provider=имя
           --profile=имя

           instance
           terminate
           --id=уникальный id

           VBoxManage cloud
           --provider=имя
           --profile=имя

           instance
           start
           --id=уникальный id

           VBoxManage cloud
           --provider=имя
           --profile=имя

           instance
           pause
           --id=уникальный id

            VBoxManage cloud
              --provider=имя
              --profile=имя

              image
              create
              --display-name=имя
              --bucket-name=имя
              --object-name=имя
              --instance-id=уникальный id

            VBoxManage cloud
            --provider=имя
            --profile=имя

            image
            info
            --id=уникальный id

            VBoxManage cloud
            --provider=имя
            --profile=имя

            image
            delete
            --id=уникальный id

            VBoxManage cloud
            --provider=имя
            --profile=имя

            image
            import
            --id=уникальный id
            --bucket-name=имя
            --object-name=имя

            VBoxManage cloud
            --provider=имя
            --profile=имя

            image
            export
            --id=уникальный id
            --display-name=имя
            --bucket-name=имя
            --object-name=имя

          VBoxManage cloud
          --provider=имя
          --profile=имя

          network setup
          --local-gateway-iso=путь
          --gateway-os-name=строка
          --gateway-os-version=строка
          --gateway-shape=строка
          --tunnel-network-name=строка
          --tunnel-network-range=строка
          --guest-additions-iso=путь
          --proxy=строка
          --compartment-id=строка

          VBoxManage cloud
          --provider=имя
          --profile=имя

          network create
          --name=строка
          --network-id=строка

            --enable
            --disable

          VBoxManage cloud network update
          --name=строка
          --network-id=строка

            --enable
            --disable

          VBoxManage cloud
          network delete
          --name=строка

          VBoxManage cloud
          network info
          --name=строка

## Описание

### Общие параметры

Слово "cloud" объединяет все команды, относящиеся к взаимодействию с облаком. Следующие общие параметры необходимо разместить между "cloud" и последующими подкомандами:

--provider=`имя`

- Короткое имя облачного провайдера.

--profile=`имя`

- Имя профиля облака.

### cloud list instances

Отображает список экземпляров указанной секции.

--state`"running/paused/terminated"`

- Состояние облачного экземпляра. На данный момент возможны следующие состояния: "running/paused/terminated". Если состояние не указано, возвращается список экземпляров со всеми возможными состояниями.

`--compartment-id`

- Секция - это логический контейнер, используемый для организации и изоляции облачных ресурсов. У разных облачных провайдеров эта сущность называется по-разному.

### cloud list images

Отображает список образов для указанной секции.

--state`"available/disabled/deleted"`

- Состояние облачного образа. На данный момент возможны следующие состояния: "available/disabled/deleted". Если состояние не указано, возвращается список образов со всеми возможными состояниями.

`--compartment-id`

- Секция - это логический контейнер, используемый для организации и изоляции облачных ресурсов. У разных облачных провайдеров эта сущность называется по-разному.

### cloud instance create

Создает новый экземпляр в облаке. Существует два стандартных способа создать экземпляр в облаке: 1. Создать экземпляр из существующего пользовательского образа. 2. Создать экземпляр из существующего загрузочного тома. Этот загрузочный том не должен быть подключен к какому-либо экземпляру. Для первого способа требуются параметры: image-id, boot-disk-size. Для второго способа требуются параметры: boot-volume-id. Остальные параметры являются общими для обоих способов: display-name, launch-mode, subnet-id, publicIP, privateIP, shape, domain.

`--domain-name`

- Облачный домен, где создается экземпляр.

`--image-id`

- Уникальный идентификатор, полностью идентифицирующий пользовательский образ в облаке.

`--boot-volume-id`

- Уникальный идентификатор, полностью идентифицирующий загрузочный том в облаке.

`--display-name`

- Имя для нового экземпляра в облаке.

`--shape`

- Форма экземпляра, определяющая количество ЦПУ и размер RAM памяти.

`--subnet`

- Уникальный идентификатор, полностью идентифицирующий существующую подсеть в облаке для использования экземпляром.

`--boot-disk-size`

- Размер загрузочного образа в ГБ. По умолчанию 50 ГБ.

`--publicip`

- У экземпляра публичный IP или нет.

`--privateip`

- Приватный IP адрес для созданного экземпляра.

`--public-ssh-key`

- Публичный ключ SSH, используемый для подключения к экземпляру через SSH. Этот параметр может быть указан несколько раз, если нужно указать несколько ключей, например: "--public-ssh-key=firstSSHKey --public-ssh-key=secondSSHKey".

`--launch-mode`

- Наиболее известные значения здесь могут быть EMULATED, NATIVE, PARAVIRTUALIZED.

`--cloud-init-script-path`

- Абсолютный путь к пользовательскому скрипту облачной инициализации.

### cloud instance info

Отображает информацию об облачном экземпляре с указанным id.

`--id`

- Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.

### cloud instance termination

Удаляет облачный экземпляр с указанным id.

`--id`

- Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.

### cloud instance start

Запускает облачный экземпляр с указанным id.

`--id`

- Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.

### cloud instance pause

Приостанавливает облачный экземпляр с указанным id.

`--id`

- Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.

### cloud image create

Создает новый образ в облаке. Существует два стандартных способа создать образ в облаке: 1. Создать образ из объекта в облачном хранилище; 2. Создать образ из существующего облачного экземпляра. Для первого способа требуются параметры: bucket-name - имя облачной корзины, где находится объект; object-name - имя объекта в корзине; display-name - имя для нового образа в облаке. Для второго способа требуются параметры: instance-id - Id экземпляра в облаке; display-name - имя для нового образа в облаке.

`--display-name`

- Имя для нового образа в облаке.

`--bucket-name`

- Имя облачной корзине, где находится объект.

`--object-name`

- Имя объекта в корзине.

`--instance-id`

- Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.

### cloud image info

Отображает информацию об облачном образе с указанным id.

`--id`

- Уникальный идентификатор, полностью идентифицирующий образ в облаке.

### cloud image delete

Удаляет образ с указанным id из облака.

`--id`

- Уникальный идентификатор, полностью идентифицирующий образ в облаке.

### cloud image import

Импортирует образ с указанным id из облака на локальный хост. Результатом является объект в локальной папке "temp" локального хоста. Возможный подход может состоят из двух основных этапов: 1. Создать объект из образа в облачном хранилище; 2. Загрузить объект на локальный хост. Поэтому, следующие параметры могут потребоваться: bucket-name - имя облачной корзины где будет создан объект; object-name - имя объекта в корзине. Если параметр "object-name" отсутствует, будет использовано показанное имя образа. Если первый этап не нужен, требуется только параметр "id".

`--id`

- Уникальный идентификатор, полностью идентифицирующий образ в облаке.

`--bucket-name`

- Имя облачной корзины, где будет создан объект.

`--object-name`

- Имя созданного объекта в корзине. У загруженного объекта будет такое же имя.

### cloud image export

Экспортирует существующий образ VBox с указанным uuid из локального хоста в облако. Результатом является новый образ в облаке. Возможный подход может состоят из двух основных этапов: 1. Загрузить образ VBox в облачное хранилище; 2. Создать образ из загруженного объекта. Поэтому, следующие параметры могут потребоваться: bucket-name - имя облачной корзины куда будет загружен объект; object-name - имя объекта в корзине. Если параметр "object-name" отсутствует, будет использован id образа; display-name - имя для нового образа в облаке. Если первый этап не нужен, требуются только параметры "id" и "display-name".

`--id`

- Уникальный идентификатор образа в VirtualBox.

`--display-name`

- Имя для нового образа в облаке.

`--bucket-name`

- Имя облачной корзины куда будет загружен образ (объект).

`--object-name`

- Имя объекта в корзине.

### cloud network setup

Настраивает окружение облачной сети для указанного облачного профиля.

`--local-gateway-iso`

- Локальный путь к установочному носителю для локального шлюза.

`--gateway-os-name`

- Имя ОС, используемой для облачного шлюза.

`--gateway-os-version`

- Версия ОС, используемой для облачного шлюза.

`--gateway-shape`

- Форма экземпляра, используемая для облачного шлюза.

`--tunnel-network-name`

- Имя VCN/подсети, используемой для туннелирования.

`--tunnel-network-range`

- Диапазон IP адресов, используемый для туннелирования.

`--guest-additions-iso`

- Локальный путь к установочному носителю Дополнений Гостевой ОС VirtualBox.

`--proxy`

- URL прокси, используемый в установке локального шлюза.

`--compartment-id`

- Секция, в которую создается туннель.

### cloud network create

Создает новый дескриптор облачной сети, связанный с существующей облачной подсетью.

`--name`

- Имя для назначения дескриптору облачной сети.

`--network-id`

- Уникальный идентификатор существующей подсети в облаке.

`--enable`, --disable

- Включить или выключить дескриптор сети. Если не указано, сеть будет включена.

### cloud network update

Изменяет существующий дескриптор облачной сети.

`--name`

- Имя существующего дескриптора облачной сети.

`--network-id`

- Уникальный идентификатор существующей подсети в облаке.

`--enable`, --disable

- Включить или выключить дескриптор сети.

### cloud network delete

Удаляет существующий дескриптор облачной сети.

`--name`

- Имя существующего дескриптора облачной сети.

### cloud network info

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

`--name`

- Имя существующего дескриптора облачной сети.