feat(webhosting): add webhosting resource (#2043)

* add support for webhosting, first try

* fixes, doc, update cassette

Author: yfodil

docs/resources/webhosting.md

@@ -0,0 +1,68 @@
+---
+subcategory: "Webhosting"
+page_title: "Scaleway: scaleway_webhosting"
+---
+
+# scaleway_webhosting
+
+Creates and manages Scaleway Web Hostings.
+For more information, see [the documentation](https://www.scaleway.com/en/developers/api/webhosting/).
+
+## Example
+
+```hcl
+data "scaleway_webhosting_offer" "by_name" {
+  name = "lite"
+}
+
+resource "scaleway_webhosting" "main" {
+  offer_id = data.scaleway_webhosting_offer.by_name.offer_id
+  email    = "[email protected]"
+  domain   = "yourdomain.com"
+  tags     = ["webhosting", "provider", "terraform"]
+}
+```
+
+## Arguments Reference
+
+The following arguments are supported:
+
+- `offer_id` - (Required) The ID of the selected offer for the hosting.
+- `email` - (Required) The contact email of the client for the hosting.
+- `domain` - (Required) TThe domain name of the hosting.
+- `option_ids` - (Optional) The IDs of the selected options for the hosting.
+- `tags` - (Optional) The tags associated with the hosting.
+- `region` - (Defaults to [provider](../index.md#region) `region`) The [region](../guides/regions_and_zones.md#regions) of the Hosting.
+- `project_id` - (Defaults to [provider](../index.md#project_id) `project_id`) The ID of the project the VPC is associated with.
+
+## Attributes Reference
+
+In addition to all above arguments, the following attributes are exported:
+
+- `id` - The ID of the hosting.
+
+~> **Important:** Hostings' IDs are [regional](../guides/regions_and_zones.md#resource-ids), which means they are of the form `{region}/{id}`, e.g. `fr-par/11111111-1111-1111-1111-111111111111
+
+- `status` - The hosting status.
+- `created_at` - Date and time of hosting's creation (RFC 3339 format).
+- `updated_at` - Date and time of hosting's last update (RFC 3339 format).
+- `platform_hostname` - The hostname of the host platform.
+- `platform_number` - The number of the host platform.
+- `offer_name` - The name of the active offer.
+- `options` - The active options of the hosting.
+    - `id` - The option ID.
+    - `name` - The option name.
+- `dns_status` - The DNS status of the hosting.
+- `cpanel_urls` - The URL to connect to cPanel Dashboard and to Webmail interface.
+    - `dashboard` - The URL of the Dashboard.
+    - `webmail` - The URL of the Webmail interface.
+- `username` - The main hosting cPanel username.
+- `organization_id` - The organization ID the hosting is associated with.
+
+## Import
+
+Hostings can be imported using the `{region}/{id}`, e.g.
+
+```bash
+$ terraform import scaleway_webhosting.hosting01 fr-par/11111111-1111-1111-1111-111111111111
+```

scaleway/helpers_webhosting.go

@@ -1,11 +1,19 @@
 package scaleway
 
 import (
+	"context"
+	"time"
+
 	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
 	webhosting "github.com/scaleway/scaleway-sdk-go/api/webhosting/v1alpha1"
 	"github.com/scaleway/scaleway-sdk-go/scw"
 )
 
+const (
+	defaultWebhostingTimeout = 5 * time.Minute
+	hostingRetryInterval     = 5 * time.Second
+)
+
 // webhostingAPIWithRegion returns a new Webhosting API and the region for a Create request
 func webhostingAPIWithRegion(d *schema.ResourceData, m interface{}) (*webhosting.API, scw.Region, error) {
 	meta := m.(*Meta)
@@ -18,6 +26,18 @@ func webhostingAPIWithRegion(d *schema.ResourceData, m interface{}) (*webhosting
 	return api, region, nil
 }
 
+// webhostingAPIWithRegionAndID returns a Webhosting API with region and ID extracted from the state
+func webhostingAPIWithRegionAndID(m interface{}, id string) (*webhosting.API, scw.Region, string, error) {
+	meta := m.(*Meta)
+	api := webhosting.NewAPI(meta.scwClient)
+
+	region, id, err := parseRegionalID(id)
+	if err != nil {
+		return nil, "", "", err
+	}
+	return api, region, id, nil
+}
+
 func flattenOfferProduct(product *webhosting.OfferProduct) interface{} {
 	return []map[string]interface{}{
 		{
@@ -37,3 +57,49 @@ func flattenOfferProduct(product *webhosting.OfferProduct) interface{} {
 func flattenOfferPrice(price *scw.Money) interface{} {
 	return price.String()
 }
+
+func flattenHostingCpanelUrls(cpanelURL *webhosting.HostingCpanelURLs) []map[string]interface{} {
+	return []map[string]interface{}{
+		{
+			"dashboard": cpanelURL.Dashboard,
+			"webmail":   cpanelURL.Webmail,
+		},
+	}
+}
+
+func flattenHostingOptions(options []*webhosting.HostingOption) []map[string]interface{} {
+	if options == nil {
+		return nil
+	}
+	flattenedOptions := []map[string]interface{}(nil)
+	for _, option := range options {
+		flattenedOptions = append(flattenedOptions, map[string]interface{}{
+			"id":   option.ID,
+			"name": option.Name,
+		})
+	}
+	return flattenedOptions
+}
+
+func waitForHosting(ctx context.Context, api *webhosting.API, region scw.Region, hostingID string, timeout time.Duration) (*webhosting.Hosting, error) {
+	retryInterval := hostingRetryInterval
+	if DefaultWaitRetryInterval != nil {
+		retryInterval = *DefaultWaitRetryInterval
+	}
+
+	return api.WaitForHosting(&webhosting.WaitForHostingRequest{
+		HostingID:     hostingID,
+		Region:        region,
+		Timeout:       scw.TimeDurationPtr(timeout),
+		RetryInterval: &retryInterval,
+	}, scw.WithContext(ctx))
+}
+
+func containsTag(tags []string, tag string) bool {
+	for _, t := range tags {
+		if t == tag {
+			return true
+		}
+	}
+	return false
+}

scaleway/provider.go

@@ -165,6 +165,7 @@ func Provider(config *ProviderConfig) plugin.ProviderFunc {
 				"scaleway_vpc_public_gateway_ip_reverse_dns":   resourceScalewayVPCPublicGatewayIPReverseDNS(),
 				"scaleway_vpc_public_gateway_pat_rule":         resourceScalewayVPCPublicGatewayPATRule(),
 				"scaleway_vpc_private_network":                 resourceScalewayVPCPrivateNetwork(),
+				"scaleway_webhosting":                          resourceScalewayWebhosting(),
 			},
 
 			DataSourcesMap: map[string]*schema.Resource{