Commit 4c5c7f76 authored by Zzzwenjie's avatar Zzzwenjie

terraform合入

parents
Pipeline #36 canceled with stages
{"Modules":[{"Key":"","Source":"","Dir":"."}]}
\ No newline at end of file
# terraform-provider-tencentcloud
## Requirements
* [Terraform](https://www.terraform.io/downloads.html) 0.13.x
* [Go](https://golang.org/doc/install) 1.13.x (to build the provider plugin)
## Usage
### Build from source code
Clone repository to: `$GOPATH/src/github.com/tencentcloudstack/terraform-provider-tencentcloud`
```sh
$ mkdir -p $GOPATH/src/github.com/tencentcloudstack
$ cd $GOPATH/src/github.com/tencentcloudstack
$ git clone https://github.com/tencentcloudstack/terraform-provider-tencentcloud.git
$ cd terraform-provider-tencentcloud
$ go build .
```
If you're building the provider, follow the instructions to [install it as a plugin.](https://www.terraform.io/docs/plugins/basics.html#installing-a-plugin) After placing it into your plugins directory, run `terraform init` to initialize it.
## Configuration
### Configure credentials
You will need to have a pair of secret id and secret key to access Tencent Cloud resources, configure it in the provider arguments or export it in environment variables. If you don't have it yet, please access [Tencent Cloud Management Console](https://console.cloud.tencent.com/cam/capi) to create one.
```
export TENCENTCLOUD_SECRET_ID=AKID9HH4OpqLJ5f6LPr4iIm5GF2s-EXAMPLE
export TENCENTCLOUD_SECRET_KEY=72pQp14tWKUglrnX5RbaNEtN-EXAMPLE
```
### Configure proxy info (optional)
If you are beind a proxy, for example, in a corporate network, you must set the proxy environment variables correctly. For example:
```
export http_proxy=http://your-proxy-host:your-proxy-port # This is just an example, use your real proxy settings!
export https_proxy=$http_proxy
export HTTP_PROXY=$http_proxy
export HTTPS_PROXY=$http_proxy
```
## Run demo
You can edit your own terraform configuration files. Learn examples from examples directory.
### Terrafrom it
Now you can try your terraform demo:
```
terraform init
terraform plan
terraform apply
```
If you want to destroy the resource, make sure the instance is already in ``running`` status, otherwise the destroy might fail.
```
terraform destroy
```
## Developer Guide
### DEBUG
You will need to set an environment variable named ``TF_LOG``, for more info please refer to [Terraform official doc](https://www.terraform.io/docs/internals/debugging.html):
```
export TF_LOG=DEBUG
```
In your source file, import the standard package ``log`` and print the message such as:
```
log.Println("[DEBUG] the message and some import values: %v", importantValues)
```
### Test
The quicker way for development and debug is writing test cases.
How to trigger running the test cases, please refer the `test.sh` script.
How to write test cases, check the `xxx_test.go` files.
### Avoid ``terrafrom init``
```
export TF_SKIP_PROVIDER_VERIFY=1
```
This will disable the verify steps, so after you update this provider, you won't need to create new resources, but use previously saved state.
### Document
Keep in mind that document changes is also needed when resources, data sources, attributes changed in code.
{
"registry.terraform.io/aliyun/alicloud": {
"hash": "h1:57vN/gnNh+hHbqLJtv1ARsA/Pfi6DkwtwGO/i17Gz6Y=",
"version": "1.105.0"
},
"registry.terraform.io/hashicorp/aws": {
"hash": "h1:3M0q/GqB24RM5E1wIu23bEbChJ2RDVaM5lTLENB92Cc=",
"version": "3.20.0"
},
"registry.terraform.io/hashicorp/azurerm": {
"hash": "h1:Gqv+2QPDoAZdQrr7EulkZJTMZETNVZigtm7x/1P91TE=",
"version": "2.39.0"
},
"registry.terraform.io/hashicorp/google": {
"hash": "h1:MgihBNqO052m2jthWBu00wWYkz+eNrETwLqBfWmvMMY=",
"version": "3.49.0"
},
"registry.terraform.io/tencentcloudstack/tencentcloud": {
"hash": "h1:ZvSAAejpPtZb1qL9CVXKJmIYC98jT9XtomS7okowGq0=",
"version": "1.49.1"
}
}
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment