azure.azcollection.azure_rm_galleryimageversion – Управление экземпляром версии изображения Azure SIG

Примечание

Этот плагин входит в коллекцию azure.azcollection (версия 1.3.1).

Для его установки используйте: ansible-galaxy collection install azure.azcollection

Для использования в playbook укажите: azure.azcollection.azure_rm_galleryimageversion

Новое в версии 0.1.2: из azure.azcollection

Обзор
Требования
Параметры
Примечания
См. также
Примеры
Возвращаемые значения

Обзор

Создание, обновление и удаление экземпляра версии изображения Azure SIG.

Требования

Ниже приведены требования к хосту, на котором будет выполняться этот модуль.

python >= 2.7
azure >= 2.0.0

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
ad_user строка				Имя пользователя Active Directory. Используется при аутентификации с пользователем Active Directory, а не с главным объектом службы.
adfs_authority_url строка добавлен в 0.0.1 azure.azcollection				URL-адрес службы Azure AD. Используется при аутентификации с именем пользователя/паролем и собственной службой ADFS.
api_profile строка добавлен в 0.0.1 azure.azcollection			По умолчанию: "latest"	Выбирает профиль API для использования при взаимодействии с Azure-службами. Значение по умолчанию `latest` подходит для общедоступных облаков; будущие значения позволят использовать Azure Stack.
append_tags булево			Варианты: нет да ←	Используется для управления тем, является ли поле тегов каноническим или просто добавляется к существующим тегам. В случае канонического поля, любые теги, которых нет в параметре тегов, будут удалены из метаданных объекта.
auth_source строка добавлен в 0.0.1 azure.azcollection			Варианты: auto ← cli credential_file env msi	Управляет источником учетных данных для аутентификации. Также может быть задан через переменную среды `ANSIBLE_AZURE_AUTH_SOURCE`. При установке в `auto` (по умолчанию) приоритет имеет модульные параметры -> `env` -> `credential_file` -> `cli`. При установке в `env`, учетные данные будут читаться из переменных среды. При установке в `credential_file`, профиль будет читаться из `~/.azure/credentials`. При установке в `cli`, учетные данные будут взяты из профиля Azure CLI. `subscription_id` или переменная среды `AZURE_SUBSCRIPTION_ID` могут использоваться для идентификации идентификатора подписки, если их несколько, иначе используется стандартная подписка az cli. При установке в `msi`, хост-машина должна быть ресурсом Azure с включенным расширением MSI. `subscription_id` или переменная среды `AZURE_SUBSCRIPTION_ID` могут использоваться для идентификации идентификатора подписки, если ресурсу предоставлен доступ к нескольким подпискам, иначе выбирается первая подписка. `msi` был добавлен в Ansible 2.6.
cert_validation_mode строка добавлен в 0.0.1 azure.azcollection			Варианты: ignore validate	Управляет поведением проверки сертификата для Azure-точек конечного доступа. По умолчанию все модули проверяют серверный сертификат, но при использовании HTTPS-прокси или подключении к Azure Stack может потребоваться отключить это поведение, передав `ignore`. Также может быть задано через профиль файла учетных данных или переменную среды `AZURE_CERT_VALIDATION`.
client_id строка				Идентификатор клиента Azure. Используется при аутентификации с помощью главного объекта службы.
cloud_environment строка добавлен в 0.0.1 azure.azcollection			По умолчанию: "AzureCloud"	Для облачных сред, отличных от общедоступного облака США, имя среды (как определено Azure Python SDK, например, `AzureChinaCloud`, `AzureUSGovernment`) или URL-адрес конечной точки обнаружения метаданных (требуется для Azure Stack). Также может быть задано через профиль файла учетных данных или переменную среды `AZURE_CLOUD_ENVIRONMENT`.
gallery_image_name строка / обязательно				Имя определения изображения галереи, в котором будет создана версия изображения.
gallery_name строка / обязательно				Имя общего хранилища изображений, в котором находится определение изображения.
location строка				Расположение ресурса.
name строка / обязательно				Имя создаваемой версии изображения галереи. Должно соответствовать шаблону имени семантической версии. Разрешенные символы: цифры и точки. Цифры должны быть в диапазоне 32-битного целого числа. Например, <MajorVersion>.<MinorVersion>.<Patch>.
password строка				Пароль пользователя Active Directory. Используется при аутентификации с пользователем Active Directory, а не с главным объектом службы.
profile строка				Профиль безопасности, найденный в файле ~/.azure/credentials.
publishing_profile словарь / обязательно				Профиль публикации.
	end_of_life_date строка			Дата окончания срока службы версии изображения галереи. Этот параметр может использоваться для целей вывода из эксплуатации. Этот параметр может быть обновлен. Формат должен соответствовать ISO-8601, например "2019-06-26".
	exclude_from_latest булево		Варианты: нет да	Если exclude_from_latest=true, виртуальные машины, развернутые из последней версии определения изображения, не будут использовать эту версию изображения.
	managed_image строка			Ссылка на управляемое изображение, может быть идентификатором ресурса или словарем, содержащим resource_group и name Устарело начиная с 2.10, используйте storage_profile вместо этого
	replica_count целое число			Количество реплик версии изображения, создаваемых в каждом регионе. Этот параметр будет применяться к региону, когда regionalReplicaCount не указан. Этот параметр может быть обновлен.
	snapshot строка			Используемый исходный снимок. Устарело начиная с 2.10, используйте storage_profile вместо этого
	storage_account_type строка			Указывает тип хранилища, который будет использоваться для хранения изображения. Этот параметр не может быть обновлен.
	target_regions список / элементы=строка			Целевые регионы, в которых будет происходить репликация версии изображения. Этот параметр может быть обновлен.
		name строка		Название региона.
		regional_replica_count строка		Количество реплик версии изображения, создаваемых в каждом регионе. Этот параметр будет применяться к региону, когда regionalReplicaCount не указан. Этот параметр может быть обновлен.
		storage_account_type строка		Тип хранилища.
resource_group строка / обязательно				Имя группы ресурсов.
secret строка				Секретный ключ клиента Azure. Используется при аутентификации с помощью главного объекта службы.
state строка			Варианты: отсутствует наличие ←	Утверждает состояние GalleryImageVersion. Используйте `present`, чтобы создать или обновить GalleryImageVersion, и `absent`, чтобы удалить его.
storage_profile словарь / обязательно				Профиль хранения.
	data_disks список / элементы=строка			Список снимков дисков данных. Взаимоисключающее с source_image
		host_caching строка	Варианты: Нет ← ReadOnly ReadWrite	Кэширование диска хоста.
		lun целое число		LUN диска данных.
		source строка		Ссылка на снимок диска данных. Может быть идентификатором ресурса или словарем, содержащим resource_group и name
	os_disk сырой			Снимок операционной системы. Взаимоисключающее с source_image
		host_caching строка	Варианты: Нет ← ReadOnly ReadWrite	Кэширование диска хоста.
		source строка		Ссылка на снимок диска ОС. Может быть идентификатором ресурса или словарем, содержащим resource_group и name

	source_image raw	Ссылка на управляемый образ или версию изображения галереи Может быть идентификатором ресурса управляемого изображения, или словарем, содержащим resource_group и name Может быть идентификатором ресурса версии изображения, или словарем, содержащим resource_group, gallery_name, gallery_image_name и version Исключительно с os_disk и data_disks
subscription_id string		Ваш идентификатор подписки Azure.
tags dictionary		Словарь пар «строка:строка» для назначения метаданных объекту. Метаданные объекта будут обновлены любыми предоставленными значениями. Чтобы удалить теги, установите опцию append_tags в false.
tenant string		Идентификатор Azure-аренды. Используется при аутентификации с помощью Служебного принципала.

Примечания

Примечание

Для аутентификации с Azure вы можете передать параметры, установить переменные среды, использовать профиль, сохраненный в ~/.azure/credentials, или войти в систему до выполнения задач или плана с az login.
Аутентификация также возможна с использованием служебного принципала или пользователя Active Directory.
Для аутентификации через служебного принципала передайте subscription_id, client_id, secret и tenant или установите переменные среды AZURE_SUBSCRIPTION_ID, AZURE_CLIENT_ID, AZURE_SECRET и AZURE_TENANT.
Для аутентификации через пользователя Active Directory передайте ad_user и password или установите AZURE_AD_USER и AZURE_PASSWORD в среде.
В качестве альтернативы учетные данные могут быть сохранены в ~/.azure/credentials. Это ini-файл, содержащий раздел [default] и следующие ключи: subscription_id, client_id, secret и tenant или subscription_id, ad_user и password. Также возможно добавление дополнительных профилей. Укажите профиль, передав profile или установив AZURE_PROFILE в среде.

См. также

Вход в Azure CLI: Как выполнить аутентификацию с помощью команды az login.

Примеры

- name: Create a gallery image version form a managed image
  azure_rm_galleryimageversion:
    resource_group: myResourceGroup
    gallery_name: myGallery
    gallery_image_name: myGalleryImage
    name: 1.1.0
    location: East US
    publishing_profile:
      end_of_life_date: "2020-10-01t00:00:00+00:00"
      exclude_from_latest: yes
      replica_count: 4
      storage_account_type: Standard_LRS
      target_regions:
        - name: West US
          regional_replica_count: 1
        - name: East US
          regional_replica_count: 3
          storage_account_type: Standard_LRS
    storage_profile:
        source_image: /subscriptions/sub123/resourceGroups/group123/providers/Microsoft.Compute/images/myOsImage

- name: Create a gallery image version from another gallery image version
  azure_rm_galleryimageversion:
    resource_group: myResourceGroup
    gallery_name: myGallery
    gallery_image_name: myGalleryImage
    name: 1.2.0
    location: East US
    publishing_profile:
      end_of_life_date: "2020-10-01t00:00:00+00:00"
      exclude_from_latest: yes
      replica_count: 4
      storage_account_type: Standard_LRS
      target_regions:
        - name: West US
          regional_replica_count: 1
        - name: East US
          regional_replica_count: 3
          storage_account_type: Standard_LRS
    storage_profile:
        source_image:
            version: 1.1.0
            gallery_name: myGallery2
            gallery_image_name: myGalleryImage2

- name: Create gallery image by using one os dist snapshot and zero or many data disk snapshots
  azure_rm_galleryimageversion:
    resource_group: myRsourceGroup
    gallery_name: myGallery
    gallery_image_name: myGalleryImage
    name: 3.4.0
    location: East  US
    publishing_profile:
      end_of_life_date: "2020-10-01t00:00:00+00:00"
      exclude_from_latest: yes
      replica_count: 1
      storage_account_type: Standard_LRS
      target_regions:
        - name: East US
          regional_replica_count: 1
          storage_account_type: Standard_LRS
    storage_profile:
      os_disk:
          source: "/subscriptions/mySub/resourceGroups/myGroup/providers/Microsoft.Compute/snapshots/os_snapshot_vma"
      data_disks:
          - lun: 0
            source:
              name: data_snapshot_vma
          - lun: 1
            source: "/subscriptions/mySub/resourceGroups/myGroup/providers/Microsoft.Compute/snapshots/data_snapshot_vmb"

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое	Описание
id string	всегда	Идентификатор ресурса. Пример: /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalle ry1283/images/myImage/versions/10.1.3

Авторы

Zim Kalinowski (@zikalino)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/azure/azcollection/azure_rm_galleryimageversion_module.html