terraform-provider-st-byteplus

README

Terraform Custom Provider for Byteplus

This Terraform custom provider is designed for own use case scenario.

Supported Versions

Terraform version	minimum provider version	maxmimum provider version
>= 1.8.x	0.1.1	latest

Requirements

• Terraform 1.8.x
• Go 1.19 (to build the provider plugin)

Local Installation

1. Run make file make install-local-custom-provider to install the provider under ~/.terraform.d/plugins.

2. The provider source should be change to the path that configured in the Makefile:

   terraform {
     required_providers {
       st-byteplus = {
         source = "example.local/myklst/st-byteplus"
       }
     }
   }
   
   provider "st-byteplus" {
     region= "ap-singapore-1"
   }
   

Why Custom Provider

This custom provider exists due to some of the resources and data sources in the official Byteplus Terraform provider may not fulfill the requirements of some scenario. The reason behind every resources and data sources are stated as below:

Resource

• st-byteplus_iam_policy

  This resource is designed to handle policy content that exceeds the limit of 6144 characters. It provides functionality to create policies by splitting the content into smaller segments that fit within the limit, enabling the management and combination of these segments to form the complete policy. Finally, the policy will be attached to the relevant user.

Data Sources

• st-byteplus_cdn_domain

  • Added client_config block to allow overriding the Provider configuration.

References

• Website: https://www.terraform.io
• Terraform Plugin Framework: https://developer.hashicorp.com/terraform/tutorials/providers-plugin-framework
• Byteplus official Terraform provider: https://github.com/byteplus-sdk/terraform-provider-byteplus