Модуль google.cloud.gcp_sql_instance_info – сбор информации об экземпляре GCP
Примечание
Этот модуль входит в коллекцию google.cloud (версия 1.13.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install google.cloud. Для использования этого модуля требуются дополнительные зависимости. Подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: google.cloud.gcp_sql_instance_info.
Обзор
- Сбор информации об экземпляре GCP
Требования
На хосте, выполняющем этот модуль, должны быть установлены следующие компоненты.
- python >= 2.6
- requests >= 2.18.4
- google-auth >= 1.3.0
Параметры
Параметр | Описание |
|---|---|
access_token string | Токен доступа OAuth2, если выбран тип учетных данных accesstoken. |
auth_kind string / обязательный | Тип используемых учетных данных. Варианты:
|
env_type string | Указывает, в какой среде Ansible выполняется этот модуль. Не задавайте этот параметр, если не уверены в его назначении. Этот параметр изменяет только строку User Agent для всех запросов к API. |
project string | Проект Google Cloud Platform, который нужно использовать. |
scopes list / элементы=string | Массив используемых областей доступа |
service_account_contents jsonarg | Содержимое JSON-файла учетной записи службы: словарь или строка JSON, представляющая это содержимое. |
service_account_email string | Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount и пользователь не хочет использовать адрес по умолчанию. |
service_account_file path | Путь к JSON-файлу учетной записи службы, если в качестве типа выбрано serviceaccount. |
Примечания
Примечание
- Для аутентификации можно задать service_account_file с помощью переменной среды
GCP_SERVICE_ACCOUNT_FILE. - Для аутентификации можно задать service_account_contents с помощью переменной среды
GCP_SERVICE_ACCOUNT_CONTENTS. - Для аутентификации можно задать service_account_email с помощью переменной среды
GCP_SERVICE_ACCOUNT_EMAIL. - Для аутентификации можно задать access_token с помощью переменной среды
GCP_ACCESS_TOKEN. - Для аутентификации можно задать auth_kind с помощью переменной среды
GCP_AUTH_KIND. - Для аутентификации можно задать scopes с помощью переменной среды
GCP_SCOPES. - Значения переменных среды используются только в том случае, если значения не заданы в плейбуке.
- Параметры service_account_email и service_account_file взаимоисключающие.
Примеры
- name: get info on an instance
gcp_sql_instance_info:
project: test_project
auth_kind: serviceaccount
service_account_file: "/tmp/auth.pem"
Возвращаемые значения
Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
resources complex | Список ресурсов Возвращается: всегда |
|
backendType string |
* FIRST_GEN: экземпляр первого поколения. Только MySQL. * SECOND_GEN: экземпляр второго поколения или экземпляр PostgreSQL. * EXTERNAL: сервер базы данных, управляемый не Google. Возвращается: при успешном выполнении |
|
connectionName string |
Имя подключения экземпляра Cloud SQL, используемое в строках подключения. Возвращается: при успешном выполнении |
|
databaseVersion string |
Тип и версия ядра базы данных. Для экземпляров первого поколения может иметь значение MYSQL_5_5 или MYSQL_5_6. Для экземпляров второго поколения может иметь значение MYSQL_5_6 или MYSQL_5_7. По умолчанию — MYSQL_5_6. Экземпляры PostgreSQL: POSTGRES_9_6. Свойство databaseVersion нельзя изменить после создания экземпляра. Возвращается: при успешном выполнении |
|
diskEncryptionConfiguration complex |
Настройки шифрования диска. Возвращается: при успешном выполнении |
|
kmsKeyName string |
Ключ KMS, используемый для шифрования экземпляра Cloud SQL. Возвращается: при успешном выполнении |
|
diskEncryptionStatus complex |
Статус шифрования диска. Возвращается: при успешном выполнении |
|
kmsKeyVersionName string |
Версия ключа KMS, используемая для шифрования экземпляра Cloud SQL. Возвращается: при успешном выполнении |
|
failoverReplica complex |
Имя и статус резервной реплики для переключения при сбое. Это свойство применимо только к экземплярам второго поколения. Возвращается: при успешном выполнении |
|
available boolean |
Статус доступности резервной реплики для переключения при сбое. Значение false указывает, что реплика рассинхронизирована. Переключение с основного экземпляра на резервную реплику возможно, только если статус имеет значение true. Возвращается: при успешном выполнении |
|
name string |
Имя резервной реплики для переключения при сбое. Если это имя указано при создании экземпляра, для него создаётся резервная реплика. Имя не включает идентификатор проекта. Это свойство применимо только к экземплярам второго поколения. Возвращается: при успешном выполнении |
|
gceZone string |
Зона Compute Engine, из которой в настоящее время обслуживается экземпляр. Это значение может отличаться от зоны, указанной при создании экземпляра, если экземпляр переключился на резервную зону. Возвращается: при успешном выполнении |
|
instanceType string |
Тип экземпляра. Может иметь одно из следующих значений. * CLOUD_SQL_INSTANCE: экземпляр Cloud SQL, который не реплицирует данные с основного экземпляра. * ON_PREMISES_INSTANCE: экземпляр, работающий в локальной инфраструктуре заказчика. * READ_REPLICA_INSTANCE: экземпляр Cloud SQL, настроенный как реплика для чтения. Возвращается: при успешном выполнении |
|
ipAddresses complex |
IP-адреса, назначенные экземпляру. Возвращается: при успешном выполнении |
|
ipAddress string |
Назначенный IP-адрес. Возвращается: при успешном выполнении |
|
timeToRetire string |
Время вывода этого IP-адреса из эксплуатации в формате RFC 3339, например 2012-11-15T16:19:00.094Z. Это поле доступно только в том случае, если вывод IP-адреса из эксплуатации запланирован. Возвращается: при успешном выполнении |
|
type string |
Тип этого IP-адреса. Адрес PRIMARY может принимать входящие подключения. Адрес OUTGOING является исходным адресом подключений, инициируемых экземпляром, если такая возможность поддерживается. Возвращается: при успешном выполнении |
|
ipv6Address string |
IPv6-адрес, назначенный экземпляру. Это свойство применимо только к экземплярам первого поколения. Возвращается: при успешном выполнении |
|
masterInstanceName string |
Имя экземпляра, который будет выполнять роль основного в конфигурации репликации. Возвращается: при успешном выполнении |
|
maxDiskSize integer |
Максимальный размер диска экземпляра в байтах. Возвращается: при успешном выполнении |
|
name string |
Имя экземпляра Cloud SQL. Не включает идентификатор проекта. Возвращается: при успешном выполнении |
|
region string |
Географический регион. По умолчанию — us-central или us-central1 в зависимости от типа экземпляра (первое поколение или второе поколение/PostgreSQL). Возвращается: при успешном выполнении |
|
replicaConfiguration complex |
Конфигурация, относящаяся к резервным репликам для переключения при сбое и репликам для чтения. Возвращается: при успешном выполнении |
|
failoverTarget boolean |
Указывает, является ли реплика целевой для переключения при сбое. Если для поля задано значение true, реплика будет назначена резервной репликой для переключения при сбое. В случае сбоя основного экземпляра экземпляр-реплика станет новым основным экземпляром. Целевой для переключения при сбое можно назначить только одну реплику. Она должна находиться в другой зоне, чем основной экземпляр. Возвращается: при успешном выполнении |
|
mysqlReplicaConfiguration complex |
Специальная конфигурация MySQL для репликации с локального основного сервера MySQL. Сведения о конфигурации репликации, такие как имя пользователя, пароль, сертификаты и ключи, не сохраняются в метаданных экземпляра. Эти сведения используются только для настройки подключения для репликации и сохраняются MySQL в файле master.info в каталоге данных. Возвращается: при успешном выполнении |
|
caCertificate string |
Представление доверенного сертификата x509 центра сертификации в формате PEM. Возвращается: при успешном выполнении |
|
clientCertificate string |
Представление сертификата x509 реплики в формате PEM. Возвращается: при успешном выполнении |
|
clientKey string |
Представление закрытого ключа реплики в формате PEM. Соответствующий открытый ключ закодирован в сертификате клиента. Возвращается: при успешном выполнении |
|
connectRetryInterval integer |
Интервал ожидания между повторными попытками подключения в секундах. Значение по умолчанию для MySQL — 60 секунд. Возвращается: при успешном выполнении |
|
dumpFilePath string |
Путь к файлу дампа SQL в Google Cloud Storage, на основе которого создаётся экземпляр-реплика. URI имеет формат gs://bucketName/fileName. Также поддерживаются сжатые файлы gzip (.gz). Дампы должны содержать координаты binlog, с которых должна начинаться репликация. Чтобы обеспечить это, при использовании mysqldump задайте для параметра --master-data значение 1. Возвращается: при успешном выполнении |
|
masterHeartbeatPeriod integer |
Интервал между сигналами проверки связи при репликации в миллисекундах. Возвращается: при успешном выполнении |
|
password string |
Пароль для подключения репликации. Возвращается: при успешном выполнении |
|
sslCipher string |
Список допустимых шифров для использования при SSL-шифровании. Возвращается: при успешном выполнении |
|
username string |
Имя пользователя для подключения репликации. Возвращается: при успешном выполнении |
|
verifyServerCertificate boolean |
Проверять ли значение общего имени основного сервера в сертификате, который он отправляет во время SSL-рукопожатия. Возвращается: при успешном выполнении |
|
replicaNames list / elements=string |
Реплики экземпляра. Возвращается: при успешном выполнении |
|
serviceAccountEmailAddress string |
Адрес электронной почты сервисного аккаунта, назначенного экземпляру. Это свойство применимо только к экземплярам второго поколения. Возвращается: при успешном выполнении |
|
serverCaCert complex |
Конфигурация SSL. Возвращается: при успешном выполнении |
|
cert string |
Представление сертификата X.509 в формате PEM. Возвращается: при успешном выполнении |
|
certSerialNumber string |
Серийный номер, извлечённый из сертификата. Возвращается: при успешном выполнении |
|
commonName string |
Имя, заданное пользователем. Должно соответствовать шаблону [a-zA-Z.-_ ]+. Возвращается: при успешном выполнении |
|
createTime string |
Время создания сертификата в формате RFC 3339, например 2012-11-15T16:19:00.094Z. Возвращается: при успешном выполнении |
|
expirationTime string |
Время истечения срока действия сертификата в формате RFC 3339, например 2012-11-15T16:19:00.094Z. Возвращается: при успешном выполнении |
|
sha1Fingerprint string |
Отпечаток сертификата SHA-1. Возвращается: при успешном выполнении |
|
settings complex |
Пользовательские настройки. Возвращается: при успешном выполнении |
|
availabilityType string |
Параметр availabilityType определяет, работает ли экземпляр PostgreSQL в одной зоне или в нескольких регионах. Возвращается: при успешном выполнении |
|
backupConfiguration complex |
Конфигурация ежедневного резервного копирования экземпляра. Возвращается: при успешном выполнении |
|
binaryLogEnabled boolean |
Включено ли ведение двоичного журнала. Если резервное копирование отключено, двоичное журналирование также должно быть отключено. Только MySQL. Возвращается: при успешном выполнении |
|
enabled boolean |
Включить автоматическое резервное копирование экземпляра. Возвращается: при успешном выполнении |
|
startTime string |
Задать время начала резервного копирования в формате UTC (HH:MM). Возвращается: при успешном выполнении |
|
databaseFlags complex |
Флаги базы данных, передаваемые экземпляру при запуске. Возвращается: при успешном выполнении |
|
name string |
Имя флага. Эти флаги передаются при запуске экземпляра, поэтому для MySQL указывайте параметры сервера и системные переменные. Флаги следует указывать с символами подчёркивания, а не дефисами. Возвращается: при успешном выполнении |
|
value string |
Значение флага. Для значения true следует указать on, а для false — off. Это поле необходимо опустить, если флаг не принимает значение. Возвращается: при успехе |
|
ipConfiguration complex |
Настройки управления IP-адресами. Они позволяют включать или отключать IP-адрес экземпляра и управлять внешними сетями, которым разрешено подключаться к экземпляру. Для экземпляров второго поколения нельзя отключить адрес IPv4. Возвращается: при успехе |
|
authorizedNetworks complex |
Список внешних сетей, которым разрешено подключаться к экземпляру по IP-адресу. Используется нотация CIDR, также известная как нотация со слешем (например, 192.168.100.0/24). Возвращается: при успехе |
|
expirationTime string |
Время истечения срока действия этой записи управления доступом в формате RFC 3339, например 2012-11-15T16:19:00.094Z. Возвращается: при успехе |
|
name string |
Необязательная метка для идентификации этой записи. Возвращается: при успехе |
|
value string |
Значение в списке разрешённых для управления доступом. Например, чтобы разрешить доступ клиенту с внешнего IP-адреса (IPv4 или IPv6) или из подсети, укажите здесь этот адрес или подсеть. Возвращается: при успехе |
|
ipv4Enabled boolean |
Следует ли назначить экземпляру IP-адрес. Возвращается: при успехе |
|
privateNetwork string |
Ссылка на ресурс сети VPC, из которой доступен частный IP-адрес экземпляра Cloud SQL (например, /projects/myProject/global/networks/default) Возвращается: при успехе |
|
requireSsl boolean |
Следует ли по умолчанию устанавливать для mysqld параметр ‘REQUIRE X509’ для пользователей, подключающихся по IP. Возвращается: при успехе |
|
settingsVersion integer |
Версия настроек экземпляра. Это обязательное поле для метода обновления, обеспечивающее корректную обработку параллельных обновлений. При обновлении используйте последнее значение settingsVersion для этого экземпляра и не пытайтесь изменить это значение. Возвращается: при успехе |
|
tier string |
Уровень или тип машины для этого экземпляра, например db-n1-standard-1. Для экземпляров MySQL это поле определяет, относится ли экземпляр ко второму (рекомендуется) или первому поколению. Возвращается: при успехе |
|
userLabels dictionary |
Метки, заданные пользователем и представленные в виде словаря, где каждая метка является парой «ключ-значение». Возвращается: при успехе |
|
state string |
Текущее состояние экземпляра базы данных. Возвращается: при успехе |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/google/cloud/gcp_sql_instance_info_module.html