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 Answer Add-Ons
Answer Add-Ons prolong Cloud Director providing with value-added functionalities. One can handle the assets and life cycle of options which can be custom-built to increase the performance of VMware Cloud Director.
A Answer 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. Answer Add-Ons are distributed as .iso recordsdata and may comprise quite a few parts: UI plugins, vApps, customers, roles, runtime outlined entities, and extra.
Terraform VCD Supplier 3.13 provides assist for Answer Add-Ons with the next new assets and information sources:
On prime of that, there are two new assets (with their information sources, as common) for Knowledge Answer configuration and publishing to tenants:
VMware Cloud Director extension for Knowledge Options is a Answer Add-On for Cloud Director, which allows multi-tenancy clients to ship a portfolio of on-demand caching, messaging and database software program. Service suppliers can supply 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 information web page. For these preferring hands-on expertise, there are additionally HCL examples.
Answer Add-On Configuration Instance (Knowledge Answer Extension)
The beneath code covers finish to finish setup of a Knowledge Answer Extension in a inexperienced discipline – it covers configuration of Answer Touchdown Zone, after which creation, instantiation and publishing of a Answer Add-On.
Notice: For brevity – these examples lack some referenced useful resource/information supply definitions. A whole set of HCL scripts might be seen within the HCL examples and higher defined within the Knowledge Answer Information Web page.
catalog {
id = vcd_catalog.solution_add_ons.id
}
vdc {
id = information.vcd_org_vdc.solutions_vdc.id
is_default = true
org_vdc_network {
id = information.vcd_network_routed_v2.options.id
is_default = true
}
compute_policy {
id = information.vcd_org_vdc.solutions_vdc.default_compute_policy_id
is_default = true
}
storage_policy {
id = information.vcd_storage_profile.options.id
is_default = true
}
}
}
useful resource “vcd_solution_add_on” “dse14” {
catalog_item_id = information.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
title = “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 = [data.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 = information.vcd_org_vdc.solutions_vdc.id is_default = true
org_vdc_network { id = information.vcd_network_routed_v2.options.id is_default = true }
compute_policy { id = information.vcd_org_vdc.solutions_vdc.default_compute_policy_id is_default = true }
storage_policy { id = information.vcd_storage_profile.options.id is_default = true } } }
useful resource “vcd_solution_add_on” “dse14” { catalog_item_id = information.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 title = “dse-14”
enter = { delete–earlier–uiplugin–variations = true }
delete_input = { pressure–delete = true } }
useful resource “vcd_solution_add_on_instance_publish” “public” { add_on_instance_id = vcd_solution_add_on_instance.dse14.id org_ids = [data.vcd_org.dse–consumer.id] publish_to_all_tenants = false }
|
Dynamic Schema Validation for Answer Add-On Instantiation
Every Answer Add-On accommodates its personal inputs that have to be validated and useful resource vcd_solution_add_on_instance
has a mechanism for dynamic enter validation within the information.
Configuring and Publishing Knowledge Options
As soon as the DSE Answer Add-On is instantiated and revealed, a supplier can leverage DSE particular assets to carry out registry configuration particulars and publish Knowledge Answer to tenants.
useful resource “vcd_dse_registry_configuration” “mongodb-community” {
title = “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 = information.vcd_org.dse-consumer.id
}
|
useful resource “vcd_dse_registry_configuration” “dso” { title = “VCD Knowledge Options” use_default_values = true }
useful resource “vcd_dse_registry_configuration” “mongodb-community” { title = “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 = information.vcd_org.dse–client.id } |
Auto-Scaling Help for Container Service Extension Kubernetes Cluster
The Kubernetes Autoscaler can mechanically regulate the dimensions 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 a substitute of the prevailing machine_count
argument:
# Regular employee pool with mounted variety of machines
worker_pool {
machine_count = 1
title = “node-pool-1”
disk_size_gi = 20
sizing_policy_id = information.vcd_vm_sizing_policy.tkg_small.id
storage_profile_id = information.vcd_storage_profile.sp.id
}
# Employee pool with the brand new Autoscaler capabilities
worker_pool {
autoscaler_min_replicas = 2
autoscaler_max_replicas = 10
title = “node-pool-2”
disk_size_gi = 20
sizing_policy_id = information.vcd_vm_sizing_policy.tkg_small.id
storage_profile_id = information.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” { title = “my-cluster” # …
# Regular employee pool with mounted variety of machines worker_pool { machine_count = 1
title = “node-pool-1” disk_size_gi = 20 sizing_policy_id = information.vcd_vm_sizing_policy.tkg_small.id storage_profile_id = information.vcd_storage_profile.sp.id }
# Employee pool with the brand new Autoscaler capabilities worker_pool { autoscaler_min_replicas = 2 autoscaler_max_replicas = 10
title = “node-pool-2” disk_size_gi = 20 sizing_policy_id = information.vcd_vm_sizing_policy.tkg_small.id storage_profile_id = information.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, in an effort to handle the employee swimming pools which can be 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 prime of the OAuth 2.0 protocol, which permits purchasers to obtain details about authenticated classes and end-users. Now you can configure organizations in VMware Cloud Director with Terraform VCD Supplier 3.13 to make use of this identification supplier resolution by utilizing the vcd_org_oidc
useful resource:
useful resource “vcd_org_oidc” “oidc” {
org_id = information.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”
}
|
information “vcd_org” “company1” { title = “company1” }
useful resource “vcd_org_oidc” “oidc” { org_id = information.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 widely known endpoint is used to retrieve all of the wanted configuration parameters. When utilizing this sort 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 = information.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 = information.vcd_provider_vdc.pvdc1.id
external_network_id = information.vcd_external_network_v2.ext_net.id
}
provider_vdc {
id = information.vcd_provider_vdc.pvdc2.id
external_network_id = information.vcd_external_network_v2.ext_net.id
}
storage_profile {
title = “*”
default = true
restrict = 1024
}
network_pool_id = information.vcd_network_pool.np1.id
readable_by_org_ids = [
data.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” { title = “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 = information.vcd_provider_vdc.pvdc1.id external_network_id = information.vcd_external_network_v2.ext_net.id }
provider_vdc { id = information.vcd_provider_vdc.pvdc2.id external_network_id = information.vcd_external_network_v2.ext_net.id }
storage_profile { title = “*” default = true restrict = 1024 }
network_pool_id = information.vcd_network_pool.np1.id
readable_by_org_ids = [ data.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. To be able 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 title = “myInstantiatedVdc” description = “A brand new VDC” org_id = information.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 fully 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 facet 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 info supply vcd_multisite_site_data
permits the administrator to gather the affiliation information wanted to arrange the operation. On the opposite facet, 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.
Related operations (utilizing the information supply vcd_multisite_org_data
and useful resource vcd_multisite_org_association
are carried out to create an affiliation between organizations. There are 5 information sources and a pair of assets to carry out the varied duties. Since it could be complicated to know what to make use of and when, now we have additionally launched a common function Website and Org affiliation information.
Right here’s an instance:
The administrator of web site 1 collects the information as follows, saving it to file site1.xml
|
information “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 information assortment and site1 affiliation).
There are two full examples about web site affiliation and group affiliation within the repository.
Checklist of New Sources and Knowledge Sources
2 new information pages:
11 new assets:
13 new information sources:
There are extra options and enhancements, which you’ll see within the mission’s changelog. And, as all the time, we’re awaiting your suggestions and ideas in GitHub Points 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.