Terraform VMware Cloud Director Supplier v3.13.0
Terraform Cloud Director Supplier v3.13.0 is obtainable now, including assist for Cloud Director 10.6 with many new options and enhancements.
Extending VCD Performance with Resolution Add-Ons
Resolution Add-Ons lengthen Cloud Director providing with value-added functionalities. One can handle the sources and life cycle of options which are custom-built to increase the performance of VMware Cloud Director.
A Resolution Add-On is the illustration of an answer that’s {custom} constructed for Cloud Director within the extensibility ecosystem. It encapsulates UI and API Cloud Director extensions along with their backend companies and lifecycle administration. Resolution Add-Ons are distributed as .iso recordsdata and may comprise quite a few components: UI plugins, vApps, customers, roles, runtime outlined entities, and extra.
Terraform VCD Supplier 3.13 provides assist for Resolution Add-Ons with the next new sources and knowledge sources:
On high of that, there are two new sources (with their knowledge sources, as normal) for Information Resolution configuration and publishing to tenants:
VMware Cloud Director extension for Information Options is a Resolution Add-On for Cloud Director, which permits multi-tenancy clients to ship a portfolio of on-demand caching, messaging and database software program. Service suppliers can provide their tenants an built-in resolution, which permits them to function and handle data-as-a-service throughout personal clouds and sovereign clouds.
There’s a new guide page. For these preferring hands-on expertise, there are additionally HCL examples.
Resolution Add-On Configuration Instance (Information Resolution Extension)
The beneath code covers finish to finish setup of a Information Resolution Extension in a inexperienced subject – it covers configuration of Resolution Touchdown Zone, after which creation, instantiation and publishing of a Resolution Add-On.
Notice: For brevity – these examples lack some referenced useful resource/knowledge supply definitions. A whole set of HCL scripts might be seen within the HCL examples and higher defined within the Data Solution Guide Page.
catalog
id = vcd_catalog.solution_add_ons.id
vdc
id = knowledge.vcd_org_vdc.solutions_vdc.id
is_default = true
org_vdc_network
id = knowledge.vcd_network_routed_v2.options.id
is_default = true
compute_policy
id = knowledge.vcd_org_vdc.solutions_vdc.default_compute_policy_id
is_default = true
storage_policy
id = knowledge.vcd_storage_profile.options.id
is_default = true
useful resource “vcd_solution_add_on” “dse14”
catalog_item_id = knowledge.vcd_catalog_media.dse14.catalog_item_id
add_on_path = var.vcd_dse_add_on_iso_path
auto_trust_certificate = true
depends_on = [vcd_solution_landing_zone.slz]
useful resource “vcd_solution_add_on_instance” “dse14”
add_on_id = vcd_solution_add_on.dse14.id
accept_eula = true
identify = “dse-14”
enter =
delete-previous-uiplugin-versions = true
delete_input =
force-delete = true
useful resource “vcd_solution_add_on_instance_publish” “public”
add_on_instance_id = vcd_solution_add_on_instance.dse14.id
org_ids = [knowledge.vcd_org.dse-consumer.id]
publish_to_all_tenants = false
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56
|
useful resource “vcd_solution_landing_zone” “slz” org = var.vcd_solutions_org
catalog id = vcd_catalog.solution_add_ons.id
vdc id = knowledge.vcd_org_vdc.solutions_vdc.id is_default = true
org_vdc_network id = knowledge.vcd_network_routed_v2.options.id is_default = true
compute_policy id = knowledge.vcd_org_vdc.solutions_vdc.default_compute_policy_id is_default = true
storage_policy id = knowledge.vcd_storage_profile.options.id is_default = true
useful resource “vcd_solution_add_on” “dse14” catalog_item_id = knowledge.vcd_catalog_media.dse14.catalog_item_id add_on_path = var.vcd_dse_add_on_iso_path auto_trust_certificate = true
depends_on = [vcd_solution_landing_zone.slz]
useful resource “vcd_solution_add_on_instance” “dse14” add_on_id = vcd_solution_add_on.dse14.id accept_eula = true identify = “dse-14”
enter = delete–earlier–uiplugin–variations = true
delete_input = drive–delete = true
useful resource “vcd_solution_add_on_instance_publish” “public” add_on_instance_id = vcd_solution_add_on_instance.dse14.id org_ids = [knowledge.vcd_org.dse–client.id] publish_to_all_tenants = false
|
Dynamic Schema Validation for Resolution Add-On Instantiation
Every Resolution Add-On comprises its personal inputs that should be validated and useful resource vcd_solution_add_on_instance
has a mechanism for dynamic input validation in the guide.
Configuring and Publishing Information Options
As soon as the DSE Resolution Add-On is instantiated and printed, a supplier can leverage DSE particular sources to carry out registry configuration particulars and publish Information Resolution to tenants.
useful resource “vcd_dse_registry_configuration” “mongodb-community”
identify = “MongoDB Neighborhood”
use_default_values = true
useful resource “vcd_dse_solution_publish” “mongodb-community”
data_solution_id = vcd_dse_registry_configuration.mongodb-community.id
org_id = knowledge.vcd_org.dse-consumer.id
|
useful resource “vcd_dse_registry_configuration” “dso” identify = “VCD Information Options” use_default_values = true
useful resource “vcd_dse_registry_configuration” “mongodb-community” identify = “MongoDB Neighborhood” use_default_values = true
useful resource “vcd_dse_solution_publish” “mongodb-community” data_solution_id = vcd_dse_registry_configuration.mongodb–neighborhood.id
org_id = knowledge.vcd_org.dse–client.id
|
Auto-Scaling Help for Container Service Extension Kubernetes Cluster
The Kubernetes Autoscaler can mechanically modify the scale of employee swimming pools in CSE. Terraform VCD Supplier 3.13 permits to configure the auto-scaling capabilities for each employee pool by specifying the minimal and most nodes. This can be utilized as an alternative of the present machine_count
argument:
# Regular employee pool with mounted variety of machines
worker_pool
machine_count = 1
identify = “node-pool-1”
disk_size_gi = 20
sizing_policy_id = knowledge.vcd_vm_sizing_policy.tkg_small.id
storage_profile_id = knowledge.vcd_storage_profile.sp.id
# Employee pool with the brand new Autoscaler capabilities
worker_pool
autoscaler_min_replicas = 2
autoscaler_max_replicas = 10
identify = “node-pool-2”
disk_size_gi = 20
sizing_policy_id = knowledge.vcd_vm_sizing_policy.tkg_small.id
storage_profile_id = knowledge.vcd_storage_profile.sp.id
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
|
useful resource “vcd_cse_kubernetes_cluster” “my_cluster” identify = “my-cluster” # …
# Regular employee pool with mounted variety of machines worker_pool machine_count = 1
identify = “node-pool-1” disk_size_gi = 20 sizing_policy_id = knowledge.vcd_vm_sizing_policy.tkg_small.id storage_profile_id = knowledge.vcd_storage_profile.sp.id
# Employee pool with the brand new Autoscaler capabilities worker_pool autoscaler_min_replicas = 2 autoscaler_max_replicas = 10
identify = “node-pool-2” disk_size_gi = 20 sizing_policy_id = knowledge.vcd_vm_sizing_policy.tkg_small.id storage_profile_id = knowledge.vcd_storage_profile.sp.id
|
When autoscaler_max_replicas
and autoscaler_min_replicas
are set in any employee pool, the Kubernetes Autoscaler is mechanically deployed to the cluster, with the intention to handle the employee swimming pools which are configured this manner. Extra particulars concerning the Autoscaler might be learn in the official FAQ doc.
OpenID Join Help
OpenID Join is an authentication layer on high of the OAuth 2.0 protocol, which permits shoppers to obtain details about authenticated periods and end-users. Now you can configure organizations in VMware Cloud Director with Terraform VCD Supplier 3.13 to make use of this id supplier resolution through the use of the vcd_org_oidc
useful resource:
useful resource “vcd_org_oidc” “oidc”
org_id = knowledge.vcd_org.my_org.id
enabled = true
prefer_id_token = false
client_id = “superClient”
client_secret = “i-am-a-secret”
max_clock_skew_seconds = 60
wellknown_endpoint = “https://my-idp.company1.com/oidc/.well-known/openid-configuration”
|
knowledge “vcd_org” “company1” identify = “company1”
useful resource “vcd_org_oidc” “oidc” org_id = knowledge.vcd_org.my_org.id enabled = true prefer_id_token = false client_id = “superClient” client_secret = “i-am-a-secret” max_clock_skew_seconds = 60 wellknown_endpoint = “https://my-idp.company1.com/oidc/.well-known/openid-configuration”
|
Within the instance above, a well known endpoint is used to retrieve all of the wanted configuration parameters. When utilizing this type of endpoint, one can even override any of the obtained values, if wanted:
# Overrides:
access_token_endpoint = “https://my-other-idp.company2.com/oidc/token”
userinfo_endpoint = “https://my-other-idp.company2.com/oidc/userinfo”
|
useful resource “vcd_org_oidc” “oidc” org_id = knowledge.vcd_org.my_org.id enabled = true prefer_id_token = false client_id = “superClient” client_secret = “i-am-a-secret” max_clock_skew_seconds = 60 wellknown_endpoint = “https://my-idp.company1.com/oidc/.well-known/openid-configuration”
# Overrides: access_token_endpoint = “https://my-other-idp.company2.com/oidc/token” userinfo_endpoint = “https://my-other-idp.company2.com/oidc/userinfo”
|
This useful resource can be utilized both by suppliers, to configure OIDC for the System group, or by tenants, to configure OIDC for every tenant.
VDC Template Help
Suppliers can now create and handle VDC Templates with the vcd_org_vdc_template
useful resource. A VDC template specifies a configuration for a corporation VDC and, optionally, an Edge Gateway and group VDC community.
The configuration of a VDC Template is similar to how configuring a VDC appears to be like like:
compute_configuration
cpu_limit = 0
cpu_guaranteed = 20
cpu_speed = 256
memory_limit = 1024
memory_guaranteed = 30
provider_vdc
id = knowledge.vcd_provider_vdc.pvdc1.id
external_network_id = knowledge.vcd_external_network_v2.ext_net.id
provider_vdc
id = knowledge.vcd_provider_vdc.pvdc2.id
external_network_id = knowledge.vcd_external_network_v2.ext_net.id
storage_profile
identify = “*”
default = true
restrict = 1024
network_pool_id = knowledge.vcd_network_pool.np1.id
readable_by_org_ids = [
knowledge.vcd_org.org.id
]
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
|
useful resource “vcd_org_vdc_template” “tmpl1” identify = “myTemplate” description = “Requires System privileges” tenant_name = “myAwesomeTemplate” tenant_description = “Any tenant can use this” allocation_model = “AllocationVApp”
compute_configuration cpu_limit = 0 cpu_guaranteed = 20 cpu_speed = 256 memory_limit = 1024 memory_guaranteed = 30
provider_vdc id = knowledge.vcd_provider_vdc.pvdc1.id external_network_id = knowledge.vcd_external_network_v2.ext_net.id
provider_vdc id = knowledge.vcd_provider_vdc.pvdc2.id external_network_id = knowledge.vcd_external_network_v2.ext_net.id
storage_profile identify = “*” default = true restrict = 1024
network_pool_id = knowledge.vcd_network_pool.np1.id
readable_by_org_ids = [ knowledge.vcd_org.org.id ]
|
As soon as the VDC Template is created, it may be instantiated by any supplier, or by any tenant person with the required rights, and if it was set within the readably_by_org_ids
argument. With the intention to do this, one can leverage the vcd_org_vdc_template_instance
useful resource:
# This ensures that eradicating this useful resource from HCL will not take away
# the instantiated VDC. Set it to “true” to take away the VDC when this
# useful resource is eliminated.
delete_instantiated_vdc_on_removal = false
delete_force = false
delete_recursive = false
|
useful resource “vcd_org_vdc_template_instance” “my_instance” org_vdc_template_id = vcd_org_vdc_template.tmpl1.id identify = “myInstantiatedVdc” description = “A brand new VDC” org_id = knowledge.vcd_org.org.id
# This ensures that eradicating this useful resource from HCL will not take away # the instantiated VDC. Set it to “true” to take away the VDC when this # useful resource is eliminated. delete_instantiated_vdc_on_removal = false delete_force = false delete_recursive = false
|
Customers can management what to do when the vcd_org_vdc_template_instance
useful resource is eliminated, with the delete_instantiated_vdc_on_removal
flag and auxiliary flags delete_force
and delete_recursive
. In the event that they don’t need the useful resource to delete the VDC when it’s faraway from HCL configuration, delete_instantiated_vdc_on_removal=false
will keep away from exactly that. That is helpful when the instantiated VDC is imported as a subsequent step, and utterly managed by a vcd_org_vdc
useful resource, as a result of customers can then discard the vcd_org_vdc_template_instance
code block with none aspect impact.
VCD and Group Affiliation (Multi-Website)
An affiliation between VCDs is completed by the collaboration between the directors of the 2 websites (or the coordinated motion of an administrator that personal each VCDs). The information supply vcd_multisite_site_data
permits the administrator to gather the affiliation knowledge wanted to arrange the operation. On the opposite aspect, the administrator of the receiving VCD will use the useful resource vcd_multisite_site_association
to set the connection. When either side have carried out each operations, the affiliation is completed.
Comparable operations (utilizing the info supply vcd_multisite_org_data
and useful resource vcd_multisite_org_association
are carried out to create an affiliation between organizations. There are 5 knowledge sources and a pair of sources to carry out the varied duties. Since it might be complicated to grasp what to make use of and when, we have now additionally launched a normal function Site and Org association guide.
Right here’s an instance:
The administrator of website 1 collects the info as follows, saving it to file site1.xml
|
knowledge “vcd_multisite_site_data” “site1” download_to_file = “site1.xml”
|
The administrator of site2 will then create the affiliation:
|
useful resource “vcd_multisite_site_association” “site2-site1” association_data_file = “site1.xml”
|
After that, the 2 directors swap roles and run the identical operations in reverse order (site2 knowledge assortment and site1 affiliation).
There are two full examples about site association and organization association within the repository.
Checklist of New Assets and Information Sources
2 new information pages:
11 new sources:
13 new knowledge sources:
There are extra options and enhancements, which you’ll be able to see within the project’s changelog. And, as all the time, we’re awaiting your suggestions and ideas in GitHub Issues and #vcd-terraform-dev Slack channel (https://the-code-community.slack.com).
Final however not least, there’s a new model v2.25.0 of Go SDK for VMware Cloud Director.