This is the first terraform provider for anypoint platform! We aim to provide a sustainable tool to automate your actions in anypoint.
This project was initiated by Mulesoft's consultants and architects from the professional team. We welcome any volunteers interested in joining the initiative no matter where you're from !
This provider uses the anypoint platform APIs to perform actions for each one of the implemented resources.
We use the anypoint client library as an abstraction layer to perform actions on the platform.
For better maintainability and in order to speed up the development process, the anypoint client library is a library generated from OAS3 specifications written by the community.
The following image describes the delivery cycle:
The cycle is composed of 3 steps:
- Pick one resource and understand how it works using tools like Postman, anypoint's documentation and your favorite browser's inspector.
- Create the OAS3 specification. The specification should at least contain GET, POST and DELETE operations. The specification should be contributed here. Using the OAS spec, a go module will be generated and pushed here.
3. Implement the resource and related data sources in the provider using the generated library.
Run the following command to build the provider
go build -o terraform-provider-anypointN.B: As of Go 1.13 make sure that your GOPRIVATE environment variable includes github.com/salesforce
go env -w GOPRIVATE=github.com/salesforceFirst, build and install the provider.
make installThen, navigate inside the examples folder, and update your credentials in main.tf.
Run the following command to initialize the workspace and apply the sample configuration.
terraform init && terraform applyIf you prefer to have your credentials in a separate file, create a params.tfvars.json file in the examples folder. Then add your parameters as shown in the example below:
{
"client_id": "REMPLACE_HERE",
"client_secret": "REMPLACE_HERE",
"org_id": "REMPLACE_HERE"
}Make sure to add the params file when you apply your terraform configuration as follow:
terraform init && terraform apply -var-file="params.tfvars.json"First build the project using
go buildYou should have a new file terraform-provider-anypoint in the root of the project. To start the provider in debug mode execute the following:
dlv exec --headless ./terraform-provider-anypoint -- --debugOnce executed, connect your debugger (whether it's your IDE or the debugger client) to the debugger server. The following is an example of how to start a client debugger:
dlv connect 127.0.0.1:51495Then have your client debugger continue execution (check the help for more info) then your provider should print something like:
TF_REATTACH_PROVIDERS='{"anypoint.mulesoft.com/automation/anypoint":{"Protocol":"grpc","Pid":69612,"Test":true,"Addr":{"Network":"unix","String":"/var/folders/yc/k0_j_x0945jdthsw7fzw5ysh0000gp/T/plugin598168131"}}}'Now you can run terraform using the debugger, here's an example:
TF_REATTACH_PROVIDERS='{"anypoint.mulesoft.com/automation/anypoint":{"Protocol":"grpc","Pid":69612,"Test":true,"Addr":{"Network":"unix","String":"/var/folders/yc/k0_j_x0945jdthsw7fzw5ysh0000gp/T/plugin598168131"}}}' terraform apply --auto-approve -var-file="params.tfvars.json"Use log package to log. Here's an exampe:
log.Println("[DEBUG] Something happened!")In order to generate a documentation, we use tfplugindocs.
Follow documentation.
You can contribute by:
- Testing the tool and letting us know of any problems you encounter.
- Contributing specifications for resources here.
- Contributing code in the provider itself here.
Made with love.
This is an UNLICENSED software, please review the considerations. This is an open source project, it does not form part of the official MuleSoft product stack, and is therefore not included in MuleSoft support SLAs. Issues should be directed to the community, who will try to assist on a best endeavours basis. This application is distributed as is..
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent