Information about what is Building Blocks and how to use or extend these modules can be found in our Wiki
This module has been tested using Terraform 1.4.5 and various versions to up the latest at time of release. We advise upgrading to the latest version of terraform.
In your meshStack "Admin area", under the "Building Blocks" section, create a new building block for the desired module. Insert the path of that module and all the inputs and outputs necessary including the service principal and your tenant information. Then wait for the terraform runner to apply you configuration and generate necessary outputs. For more detailed steps, please refer to the module's readme file.
- Before deploying any module to the cloud environment, it is imperative to have an Azure service principal (or an IAM user in AWS, or a Service account in GCP) with appropriate permissions at the desired scope. It is possible to utilize an existing service principal for this purpose, or you can refer to the provided links below to set up a new service principal within the targeted environment:
- Azure Service principal module
- AWS IAM User module
- GCP Service account module
Based on the recource you are going to deploy, you have to assign required role to the service principal. For Instance, in Azure you can assign the contributor role in the "meshcloud's management group" scope. However, it is recommended to have the "policy of least privilege" in mind.
To apply one of these building block modules in your cloud environment via meshStack you need:
- Access to the meshStack Admin Area to be able to add a new building block
- Have a configured meshPlatform in your meshStack with an active project inside
- A service principal in your cloud environment which have the required permissions to apply your module
Please refer to the readme provided inside each module for a list of the required inputs.