ansible-later/env_27/lib/python2.7/site-packages/ansible/utils/module_docs_fragments/gcp.py
2019-04-11 13:00:36 +02:00

41 lines
1.5 KiB
Python

# Copyright: (c) 2018, Google Inc.
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
class ModuleDocFragment(object):
# GCP doc fragment.
DOCUMENTATION = '''
options:
project:
description:
- The Google Cloud Platform project to use.
default: null
auth_kind:
description:
- The type of credential used.
required: true
choices: ["machineaccount", "serviceaccount", "application"]
service_account_file:
description:
- The path of a Service Account JSON file if serviceaccount is selected as type.
service_account_email:
description:
- An optional service account email address if machineaccount is selected
and the user does not wish to use the default email.
scopes:
description:
- Array of scopes to be used.
notes:
- For authentication, you can set service_account_file using the
C(GCP_SERVICE_ACCOUNT_FILE) env variable.
- For authentication, you can set service_account_email using the
C(GCP_SERVICE_ACCOUNT_EMAIL) env variable.
- For authentication, you can set auth_kind using the C(GCP_AUTH_KIND) env
variable.
- For authentication, you can set scopes using the C(GCP_SCOPES) env variable.
- Environment variables values will only be used if the playbook values are
not set.
- The I(service_account_email) and I(service_account_file) options are
mutually exclusive.
'''