website: init docs

Author: DeviaVir

Makefile

@@ -1,6 +1,7 @@
 # Metadata about this makefile and position
 MKFILE_PATH := $(lastword $(MAKEFILE_LIST))
 CURRENT_DIR := $(patsubst %/,%,$(dir $(realpath $(MKFILE_PATH))))
+WEBSITE_REPO := github.com/hashicorp/terraform-website
 
 # Ensure GOPATH
 GOPATH ?= $(HOME)/go
@@ -16,7 +17,8 @@ GOMAXPROCS ?= 8
 
 # Get the project metadata
 GOVERSION := 1.14
-PROJECT := github.com/DeviaVir/terraform-provider-gsuite
+PKG_NAME := gsuite
+PROJECT := github.com/DeviaVir/terraform-provider-$(PKG_NAME)
 OWNER := $(notdir $(patsubst %/,%,$(dir $(PROJECT))))
 NAME := $(notdir $(PROJECT))
 VERSION := 0.1.49
@@ -106,7 +108,7 @@ dev: vendor
 		-mod vendor \
 		-ldflags "${LD_FLAGS}" \
 		-tags "${GOTAGS}" \
-		-o "${PLUGIN_PATH}/terraform-provider-gsuite"
+		-o "${PLUGIN_PATH}/terraform-provider-${PKG_NAME}"
 
 # test runs all tests
 test:
@@ -198,3 +200,19 @@ _sign:
 	@echo ""
 	@echo "And then upload the binaries in dist/!"
 .PHONY: _sign
+
+website:
+ifeq (,$(wildcard $(GOPATH)/src/$(WEBSITE_REPO)))
+	echo "$(WEBSITE_REPO) not found in your GOPATH (necessary for layouts and assets), get-ting..."
+	git clone https://$(WEBSITE_REPO) $(GOPATH)/src/$(WEBSITE_REPO)
+endif
+	@$(MAKE) -C $(GOPATH)/src/$(WEBSITE_REPO) website-provider PROVIDER_PATH=$(shell pwd) PROVIDER_NAME=$(PKG_NAME)
+.PHONY: website
+
+website-test:
+ifeq (,$(wildcard $(GOPATH)/src/$(WEBSITE_REPO)))
+	echo "$(WEBSITE_REPO) not found in your GOPATH (necessary for layouts and assets), get-ting..."
+	git clone https://$(WEBSITE_REPO) $(GOPATH)/src/$(WEBSITE_REPO)
+endif
+	@$(MAKE) -C $(GOPATH)/src/$(WEBSITE_REPO) website-provider-test PROVIDER_PATH=$(shell pwd) PROVIDER_NAME=$(PKG_NAME)
+.PHONY: website-test

README.md

@@ -1,90 +1,25 @@
-# Terraform G Suite Provider
+Terraform Provider - G Suite
+==================
 
-This is a terraform provider for managing G Suite (Admin SDK) resources on Google
+- Website: https://registry.terraform.io/providers/DeviaVir/gsuite/latest/docs
+- [![Gitter chat](https://badges.gitter.im/hashicorp-terraform/Lobby.png)](https://gitter.im/hashicorp-terraform/Lobby)
+- Mailing list: [Google Groups](http://groups.google.com/group/terraform-tool)
 
-## Authentication
+<img src="https://cdn.rawgit.com/hashicorp/terraform-website/master/content/source/assets/images/logo-hashicorp.svg" width="600px">
 
-There are two possible authentication mechanisms for using this provider.
-Using a service account, or a personal admin account. The latter requires
-user interaction, whereas a service account could be used in an automated
-workflow.
+Maintainers
+-----------
 
-See the necessary oauth scopes both for service accounts and users below:
-- https://www.googleapis.com/auth/admin.directory.group
-- https://www.googleapis.com/auth/admin.directory.user
+This provider plugin is maintained by Chase Sillevis.
 
-You could also provide the minimal set of scopes using the
-`oauth_scopes` variable in the provider configuration.
+Requirements
+------------
 
-```
-provider "gsuite" {
-  oauth_scopes = [
-    "https://www.googleapis.com/auth/admin.directory.group",
-    "https://www.googleapis.com/auth/admin.directory.user"
-  ]
-}
-```
+-	[Terraform](https://www.terraform.io/downloads.html) 0.11.x
+-	[Go](https://golang.org/doc/install) 1.14 (to build the provider plugin)
 
-**NOTE** If you are creating or modifying schemas and custom user attributes
-you will need the following additional scope:
-
-    https://www.googleapis.com/auth/admin.directory.userschema
-
-**NOTE 2** If you are creating or modifying group settings
-you will need the following additional scope:
-
-    https://www.googleapis.com/auth/apps.groups.settings
-
-### Using a service account
-
-Service accounts are great for automated workflows.
-
-Only users with access to the Admin APIs can access the Admin SDK Directory API,
-therefore the service account needs to impersonate one of those users
-to access the Admin SDK Directory API.
-
-Follow the instruction at
-https://developers.google.com/admin-sdk/directory/v1/guides/delegation.
-
-Add `credentials` and `impersonated_user_email` when initializing the provider.
-```
-provider "gsuite" {
-  credentials = "/full/path/service-account.json"
-  impersonated_user_email = "admin@xxx.com"
-}
-```
-
-Credentials can also be provided via the following environment variables:
-- GOOGLE_CREDENTIALS
-- GOOGLE_CLOUD_KEYFILE_JSON
-- GCLOUD_KEYFILE_JSON
-- GOOGLE_APPLICATION_CREDENTIALS
-- IMPERSONATED_USER_EMAIL
-
-### Using a personal administrator account
-
-In order to use the Admin SDK with a project, we will first need to create
-credentials for that project, you can do so here:
-
-https://console.cloud.google.com/apis/credentials?project=[project_ID]
-
-Please make sure to create an OAuth 2.0 client, and download the file to your
-local directory.
-
-You can now use that credential to authenticate:
-
-```
-$ gcloud auth application-default login \
-  --client-id-file=client_id.json \
-  --scopes \
-https://www.googleapis.com/auth/admin.directory.group,\
-https://www.googleapis.com/auth/admin.directory.user,
-```
-
-Now that you have a credential that is allowed to the Admin SDK, you can use the
-G Suite provider.
-
-## Installation
+Installing the Provider
+---------------------
 
 1. Download the latest compiled binary from [GitHub releases](https://github.com/DeviaVir/terraform-provider-gsuite/releases).
 
@@ -105,7 +40,8 @@ G Suite provider.
 
     This will find the plugin locally.
 
-## Development
+Building The Provider
+---------------------
 
 1. `cd` into `$HOME/.terraform.d/plugins/terraform-provider-gsuite`
 
@@ -116,25 +52,3 @@ G Suite provider.
 1. Run `make dev` and in your `terraform` directory, remove the current `.terraform` and re-run `terraform init`
 
 1. Next time you run `terraform plan` it'll use your updated version
-
-### Relevant Google Admin SDK Documentation
-#### General
-* http://google.golang.org/api/admin/directory/v1
-* https://developers.google.com/admin-sdk/directory/v1/reference/
-
-#### Schema Types
-* https://developers.google.com/admin-sdk/directory/v1/reference/users
-* https://developers.google.com/admin-sdk/directory/v1/reference/groups
-* https://developers.google.com/admin-sdk/directory/v1/reference/schemas
-
-When using a service account, make sure to add:
-`https://www.googleapis.com/auth/admin.directory.userschema`
-to the `oauth_scopes` list, otherwise you will be missing permissions to manage
-user schemas.
-
-## Notes
-
-- Asking too many permissions right now, but rather start out with too much and tone down later on
-- Quite limited, as it is a huge API, I have only added the parts I plan on using
-  - Open for PR's to extend functionality
-- Documentation is still to be written, you can refer to the `examples` directory for now

examples/custom-attributes/custom-attributes.tf

@@ -35,5 +35,5 @@ resource "gsuite_user" "user" {
 
 resource "gsuite_user_attributes" "user_attributes" {
   primary_email = gsuite_user.user.primary_email
-  custom_schema =  data.gsuite_user_attributes.details.json
+  custom_schema = data.gsuite_user_attributes.details.json
 }

gsuite/resource_user.go

@@ -583,7 +583,7 @@ func resourceUserCreate(d *schema.ResourceData, meta interface{}) error {
 		}
 	}
 
-	// Transimt password related state on account creation only.
+	// Transmit password related state on account creation only.
 	if v, ok := d.GetOk("password"); ok {
 		log.Printf("[DEBUG] Setting %s: %s", "password", v.(string))
 		user.Password = v.(string)

website/docs/d/group.md

@@ -0,0 +1,47 @@
+---
+layout: "gsuite"
+page_title: "G Suite: group data source"
+sidebar_current: "docs-gsuite-datasource-group"
+description: |-
+  Retrieves a Group in G Suite.
+---
+
+# gsuite\_group
+
+Reads a Group from G Suite
+
+## Example Usage
+
+```hcl
+data "gsuite_group" "example" {
+  email = "example@domain.ext"
+}
+
+output "group" {
+  value = data.gsuite_group.example
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `email` - (Required) The email of the group.
+
+## Attributes Reference
+
+In addition to the above arguments, the following attributes are exported:
+
+* `aliases`
+
+* `name`
+
+* `description`
+
+* `direct_members_count`
+
+* `admin_created`
+
+* `non_editable_aliases`
+
+* `member` - Lists the set of members in this group.