Add TiDB Resource Controls (#1)

TODO
====
- [ ] Setup automated testing for these changes
- [ ] Offer upstream to petoju repo
- [ ] Optionally build in lookups to see if current allocation is within
limits of total predicted cluster capacity
```
mysql> CALIBRATE RESOURCE START_TIME '2024-07-09 19:10:21' DURATION '30m';
+--------+
| QUOTA  |
+--------+
| 160194 |
+--------+
1 row in set (0.24 sec)

That's approx NOW() - DURATION

```

---------

Co-authored-by: Andrew Chen <[email protected]>

Author: zph

.github/workflows/main.yml

@@ -2,7 +2,7 @@ name: Main (test, releases)
 on:
   # # Indicates I want to run this workflow on all branches, PR, and tags
   push:
-    branches: ["*"]
+    branches: ["master"]
     tags: ["*"]
   pull_request:
     branches: [ "master" ]

.gitignore

@@ -4,6 +4,7 @@
 example.tf
 terraform.tfplan
 terraform.tfstate
+.terraform.lock*
 terraform-provider-mysql
 bin/
 modules-dev/

.goreleaser.yml

@@ -3,8 +3,10 @@
 version: 2
 before:
   hooks:
-    # this is just an example and not a requirement for provider building/publishing
     - go mod tidy
+    # Disabled until auto-generated docs and manual docs operate peacefully
+    # - go generate ./...
+
 builds:
   - env:
       # goreleaser does not work with CGO, it could also complicate

GNUmakefile

@@ -6,10 +6,30 @@ TERRAFORM_VERSION=0.14.7
 TERRAFORM_OS=$(shell uname -s | tr A-Z a-z)
 TEST_USER=root
 TEST_PASSWORD=my-secret-pw
-DATESTAMP=$(shell date "+%Y%m%d%H%M%S")
+DATESTAMP=$(shell date "+%Y%m%d")
 SHA_SHORT=$(shell git describe --match=FORCE_NEVER_MATCH --always --abbrev=40 --dirty --abbrev)
 MOST_RECENT_UPSTREAM_TAG=$(shell git for-each-ref refs/tags --sort=-taggerdate --format="%(refname)" | head -1 | grep -E -o "v\d+\.\d+\.\d+")
 
+OS_ARCH=linux_amd64
+# Set correct OS_ARCH on Mac
+UNAME := $(shell uname -s)
+ifeq ($(UNAME),Darwin)
+	HW := $(shell uname -m)
+	ifeq ($(HW),arm64)
+		ARCH=$(HW)
+	else
+		ARCH=amd64
+	endif
+	OS_ARCH=darwin_$(ARCH)
+endif
+
+HOSTNAME=registry.terraform.io
+NAMESPACE=zph
+NAME=mysql
+VERSION=9.9.9
+## on linux base os
+TERRAFORM_PLUGINS_DIRECTORY=~/.terraform.d/plugins/${HOSTNAME}/${NAMESPACE}/${NAME}/${VERSION}/${OS_ARCH}
+
 default: build
 
 build: fmtcheck
@@ -121,12 +141,26 @@ endif
 
 	@$(MAKE) -C $(GOPATH)/src/$(WEBSITE_REPO) website-provider PROVIDER_PATH=$(shell pwd) PROVIDER_NAME=$(PKG_NAME)
 
+install:
+	mkdir -p ${TERRAFORM_PLUGINS_DIRECTORY}
+	go build -o ${TERRAFORM_PLUGINS_DIRECTORY}/terraform-provider-${NAME}
+	cd examples && rm -rf .terraform
+	cd examples && make init
+
+re-install:
+	rm -f examples/.terraform.lock.hcl
+	rm -f ${TERRAFORM_PLUGINS_DIRECTORY}/terraform-provider-${NAME}
+	go build -o ${TERRAFORM_PLUGINS_DIRECTORY}/terraform-provider-${NAME}
+	cd examples && rm -rf .terraform
+	cd examples && terraform init
+
 format-tag:
 	@echo $(MOST_RECENT_UPSTREAM_TAG)-$(DATESTAMP)-$(SHA_SHORT)
 
 tag:
 	@echo git tag -a $(MOST_RECENT_UPSTREAM_TAG)-$(DATESTAMP)-$(SHA_SHORT) -m $(MOST_RECENT_UPSTREAM_TAG)-$(DATESTAMP)-$(SHA_SHORT)
 	@git tag -a $(MOST_RECENT_UPSTREAM_TAG)-$(DATESTAMP)-$(SHA_SHORT) -m $(MOST_RECENT_UPSTREAM_TAG)-$(DATESTAMP)-$(SHA_SHORT)
 
-
-.PHONY: build test testacc vet fmt fmtcheck errcheck vendor-status test-compile website website-test tag
+release:
+	@goreleaser release --clean --verbose
+.PHONY: build test testacc vet fmt fmtcheck errcheck vendor-status test-compile website website-test tag format-tag

README.md

@@ -13,7 +13,7 @@ fragmentation. We will update this readme if those design choices change.
 
 zph fork will use release naming in the following form:
 
-v3.0.62-20240705125429-3c7af6a
+v3.0.62-20240705-3c7af6a
 
 {petoju version}-{date}-{sha}
 

docs/data-sources/databases.md

@@ -0,0 +1,25 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "mysql_databases Data Source - terraform-provider-mysql"
+subcategory: ""
+description: |-
+  
+---
+
+# mysql_databases (Data Source)
+
+
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- `pattern` (String)
+
+### Read-Only
+
+- `databases` (List of String)
+- `id` (String) The ID of this resource.

docs/data-sources/tables.md

@@ -0,0 +1,29 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "mysql_tables Data Source - terraform-provider-mysql"
+subcategory: ""
+description: |-
+  
+---
+
+# mysql_tables (Data Source)
+
+
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `database` (String)
+
+### Optional
+
+- `pattern` (String)
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+- `tables` (List of String)