VBoxManage cloud

$Date: 2025-08-11 19:18:47 +0200 (Mon, 11 Aug 2025) $
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`

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