terraform-provider-google/website/docs/index.html.markdown
The Magician 9c8bea96d8 Refresh provider docs in anticipation of 2.0.0 (#2981)
<!-- This change is generated by MagicModules. -->
/cc @rileykarson
2019-02-01 13:26:59 -08:00

5.5 KiB

layout page_title sidebar_current description
google Provider: Google Cloud Platform docs-google-provider-x The Google provider is used to configure your Google Cloud Platform infrastructure

Google Cloud Platform Provider

-> Want more information about upgrading from 1.X of the provider to 2.0.0? Check out the 2.0.0 Upgrade Guide.

The Google provider is used to configure your Google Cloud Platform infrastructure. See the Getting Started page for an introduction to using the provider.

A typical provider configuration will look something like:

provider "google" {
  credentials = "${file("account.json")}"
  project     = "my-project-id"
  region      = "us-central1"
}

See the provider reference for more details on authenticating or otherwise configuring the provider.

Interested in the provider's latest features, or want to make sure you're up to date? Check out the changelog for version information and release notes.

Take advantage of Modules to simplify your config by browsing the Module Registry for GCP modules.

The Google provider is jointly maintained by:

If you have configuration questions, or general questions about using the provider, try checking out:

Features and Bug Requests

The Google provider's bugs and feature requests can be found in the GitHub repo issues. Please avoid "me too" or "+1" comments. Instead, use a thumbs up reaction on enhancement requests. Provider maintainers will often prioritize work based on the number of thumbs on an issue.

Community input is appreciated on outstanding issues! We love to hear what use cases you have for new features, and want to provide the best possible experience for you using the Google provider.

If you have a bug or feature request without an existing issue

The provider maintainers will often use the assignee field on an issue to mark who is working on it.

  • An issue assigned to an individual maintainer indicates that maintainer is working on the issue
  • An issue assigned to the modular-magician indicates the feature is being autogenerated by Magic Modules in the immediate future, so direct contributions to that resource are discouraged.
  • An issue assigned to hashibot indicates a member of the community has taken on the issue!

Contributing

If you'd like to help extend the Google provider, we gladly accept community contributions! Pull requests should be made against Magic Modules to ensure they are applied to both google and google-beta.

Check out the Magic Modules setup guide to get set up, the provider README for instructions about running your generated code, the HashiCorp contribution guidelines for a Terraform provider development overview, and the Google provider contribution guidelines for our provider-specific advice.

GCP API Versions

The Google provider supports generally available (GA) and Beta GCP features. We are focusing on filling out general GA feature coverage and on adding support for beta features that customers request. If you need us to support a feature whether GA or beta, please file a feature request!

If you're interested in using Alpha GCP features, you should still file a feature request or thumbs up reaction the existing request if one exists. By filing and reacting to requests, we can gauge your interest in yet-to-be-supported GCP features and make sure that we prioritize support for them when they enter Beta.