resource/gitlab_project_*_environment: initial draft of resources

Author: Ryan G

docs/resources/project_environment.md

@@ -0,0 +1,32 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_project_environment Resource - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  This resource allows you to create and manage GitLab environments.
+---
+
+# gitlab_project_environment (Resource)
+
+This resource allows you to create and manage GitLab environments.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- **name** (String) The name of the environment
+- **project** (String) The ID or full path of the project which the environment is created against.
+
+### Optional
+
+- **external_url** (String) Place to link to for this environment
+- **id** (String) The ID of this resource.
+
+### Read-Only
+
+- **state** (String) State the environment is in. Accepted values: available or stopped.
+
+

docs/resources/project_protected_environment.md

@@ -0,0 +1,41 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_project_protected_environment Resource - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  This resource allows you to create and manage Project Access Token for your GitLab projects.
+---
+
+# gitlab_project_protected_environment (Resource)
+
+This resource allows you to create and manage Project Access Token for your GitLab projects.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- **deploy_access_levels** (Block List, Min: 1) Array of access levels allowed to deploy, with each described by a hash. (see [below for nested schema](#nestedblock--deploy_access_levels))
+- **environment** (String) The name of the environment.
+- **project** (String) The ID or full path of the project which the protected environment is created against.
+
+### Optional
+
+- **id** (String) The ID of this resource.
+
+<a id="nestedblock--deploy_access_levels"></a>
+### Nested Schema for `deploy_access_levels`
+
+Optional:
+
+- **access_level** (String) Level of access required to deploy to this protected environment (developer, maintainer)
+- **group_id** (Number) The ID of the group allowed to deploy to this protected environment.
+- **user_id** (Number) The ID of the user allowed to deploy to this protected environment.
+
+Read-Only:
+
+- **access_level_description** (String) Readable description of level of access.
+
+

internal/provider/access_level_helpers.go

@@ -55,14 +55,18 @@ var validProtectedBranchUnprotectAccessLevelNames = []string{
 	"developer", "maintainer",
 }
 
+var validProtectedEnvironmentDeploymentLevelNames = []string{
+	"developer", "maintainer",
+}
+
 var accessLevelNameToValue = map[string]gitlab.AccessLevelValue{
 	"no one":     gitlab.NoPermissions,
 	"minimal":    gitlab.MinimalAccessPermissions,
 	"guest":      gitlab.GuestPermissions,
 	"reporter":   gitlab.ReporterPermissions,
 	"developer":  gitlab.DeveloperPermissions,
 	"maintainer": gitlab.MaintainerPermissions,
-	"owner":      gitlab.OwnerPermission,
+	"owner":      gitlab.OwnerPermissions,
 
 	// Deprecated and should be removed in v4 of this provider
 	"master": gitlab.MaintainerPermissions,

internal/provider/resource_gitlab_project_environment.go

@@ -0,0 +1,174 @@
+package provider
+
+import (
+	"context"
+	"fmt"
+	"log"
+	"strconv"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/validation"
+	gitlab "github.com/xanzy/go-gitlab"
+)
+
+// https://docs.gitlab.com/ee/ci/environments/protected_environments.html
+var _ = registerResource("gitlab_project_environment", func() *schema.Resource {
+	return &schema.Resource{
+		Description: `The ` + "`gitlab_project_environment`" + ` resource you to create and manage an environment in your GitLab project`,
+
+		CreateContext: resourceGitlabProjectEnvironmentCreate,
+		ReadContext:   resourceGitlabProjectEnvironmentRead,
+		UpdateContext: resourceGitlabProjectEnvironmentUpdate,
+		DeleteContext: resourceGitlabProjectEnvironmentDelete,
+		Importer: &schema.ResourceImporter{
+			StateContext: schema.ImportStatePassthroughContext,
+		},
+		Schema: map[string]*schema.Schema{
+			"project": {
+				Description:  "The ID or full path of the project to environment is created for.",
+				Type:         schema.TypeString,
+				ForceNew:     true,
+				Required:     true,
+				ValidateFunc: validation.StringIsNotEmpty,
+			},
+			"name": {
+				Description:  "The name of the environment",
+				Type:         schema.TypeString,
+				Required:     true,
+				ValidateFunc: validation.StringIsNotEmpty,
+			},
+			"external_url": {
+				Description:  "Place to link to for this environment",
+				Type:         schema.TypeString,
+				Optional:     true,
+				ValidateFunc: validation.StringIsNotEmpty,
+			},
+			"state": {
+				Description: "State the environment is in. Accepted values: available or stopped.",
+				Type:        schema.TypeString,
+				Computed:    true,
+			},
+		},
+	}
+})
+
+func resourceGitlabProjectEnvironmentCreate(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	name := d.Get("name").(string)
+	options := gitlab.CreateEnvironmentOptions{
+		Name: &name,
+	}
+	if externalURL, ok := d.GetOk("external_url"); ok {
+		options.ExternalURL = gitlab.String(externalURL.(string))
+	}
+
+	project := d.Get("project").(string)
+
+	log.Printf("[DEBUG] Project %s create gitlab environment %q", project, *options.Name)
+
+	client := meta.(*gitlab.Client)
+
+	environment, _, err := client.Environments.CreateEnvironment(project, &options, gitlab.WithContext(ctx))
+	if err != nil {
+		if is404(err) {
+			return diag.Errorf("feature Environments is not available")
+		}
+		return diag.FromErr(err)
+	}
+
+	d.SetId(buildTwoPartID(&project, gitlab.String(fmt.Sprintf("%v", environment.ID))))
+
+	return resourceGitlabProjectEnvironmentRead(ctx, d, meta)
+}
+
+func resourceGitlabProjectEnvironmentRead(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	log.Printf("[DEBUG] read gitlab environment %s", d.Id())
+
+	project, environmentID, err := parseTwoPartID(d.Id())
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	environmentIDInt, err := strconv.Atoi(environmentID)
+
+	if err == nil {
+		fmt.Printf("%T \n %v", environmentIDInt, environmentIDInt)
+	}
+
+	log.Printf("[DEBUG] Project %s read gitlab environment %d", project, environmentIDInt)
+
+	client := meta.(*gitlab.Client)
+
+	environment, _, err := client.Environments.GetEnvironment(project, environmentIDInt, gitlab.WithContext(ctx))
+	if err != nil {
+		if is404(err) {
+			log.Printf("[DEBUG] Project %s gitlab environment %q not found", project, environmentID)
+			d.SetId("")
+			return nil
+		}
+		return diag.Errorf("error getting gitlab project %q environment %q: %v", project, environmentID, err)
+	}
+
+	d.SetId(buildTwoPartID(&project, gitlab.String(fmt.Sprintf("%v", environment.ID))))
+	d.Set("project", project)
+	d.Set("name", environment.Name)
+	d.Set("state", environment.State)
+
+	return nil
+}
+
+func resourceGitlabProjectEnvironmentUpdate(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	log.Printf("[DEBUG] update gitlab environment %s", d.Id())
+
+	project, environmentID, err := parseTwoPartID(d.Id())
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	environmentIDInt, err := strconv.Atoi(environmentID)
+	if err != nil {
+		return diag.Errorf("error converting environment ID to int: %v", err)
+	}
+
+	name := d.Get("name").(string)
+	options := gitlab.EditEnvironmentOptions{
+		Name: &name,
+	}
+	if d.HasChange("external_url") {
+		options.ExternalURL = gitlab.String(d.Get("external_url").(string))
+	}
+
+	log.Printf("[DEBUG] Project %s update gitlab environment %d", project, environmentIDInt)
+
+	client := meta.(*gitlab.Client)
+
+	if _, _, err := client.Environments.EditEnvironment(project, environmentIDInt, &options, gitlab.WithContext(ctx)); err != nil {
+		return diag.Errorf("error editing gitlab project %q environment %q: %v", project, environmentID, err)
+	}
+
+	return resourceGitlabProjectEnvironmentRead(ctx, d, meta)
+}
+
+func resourceGitlabProjectEnvironmentDelete(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	project, environmentID, err := parseTwoPartID(d.Id())
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	environmentIDInt, err := strconv.Atoi(environmentID)
+	if err != nil {
+		return diag.Errorf("error converting environment ID to int: %v", err)
+	}
+
+	log.Printf("[DEBUG] Project %s delete gitlab project-level environment %v", project, environmentIDInt)
+
+	client := meta.(*gitlab.Client)
+
+	_, err = client.Environments.StopEnvironment(project, environmentIDInt, gitlab.WithContext(ctx))
+	if err != nil {
+		return diag.Errorf("error stopping gitlab project %q environment %q: %v", project, environmentID, err)
+	}
+	_, err = client.Environments.DeleteEnvironment(project, environmentIDInt, gitlab.WithContext(ctx))
+	if err != nil {
+		return diag.Errorf("error deleting gitlab project %q environment %q: %v", project, environmentID, err)
+	}
+
+	return nil
+}