Files
hunfabric/modules/artifact-registry/variables.tf
Julio Castillo 2eaa0d5e27 Add support for dynamic tags (#3897)
* Allow creation of dynamic tags

* Extend project factory and related modules to support dynamic values

* Extend folder and organization modules

* project and organization readme

* Simplify dynamic tag support and remove unnecessary restrictions

  • Schemas & Validations: Removed the restriction that forbade combining IAM fields with  allowed_values_regex  on tags. Updated validations in  project  and  organization  modules, and
  simplified all relevant JSON schemas.
  • Module Tag Bindings: Simplified the  tag_value  assignment in  folder ,  project ,  gcs ,  bigquery-dataset , and  kms  modules by removing the defensive  can(regex(...))  check and
  calling  templatestring  directly.
  • Outputs: Removed the  tags_dynamic  output from  project  and  organization  modules, as the same information is now available in  tag_keys .
  • Project Factory: Updated  tag_vars_projects  in  projects.tf  to use the native  namespaced_name  attribute and filtered manually for dynamic tags.

* fix(organization, project): fix linting and tests for dynamic tag support

- Align allowed_values_regex and description extraction in _tags_merged
  locals to use lookup() for consistency with other fields.
- Fix spacing in project context variable (alphabetical ordering).
- Update organization tags test to include the new cost_center tag key
  with allowed_values_regex.
- Update project tags test to include the new cost_center tag key and
  reflect the resolved allowed_values_regex on environment.

* refactor(gcs): refine tag bindings and fix context test

- Add _tag_bindings local to pre-resolve context references, enabling
  templatestring to receive a direct map reference (required by Terraform).
- Use var.context.tag_vars instead of the non-existent local.ctx.tag_vars.
- Fix HCL syntax in context.tfvars (escaped inner quotes).
- Update context test inventory to reflect 3 tag bindings including a
  dynamic value resolved via templatestring.

* refactor: align modules with tag binding context pattern

- Add _tag_bindings local + templatestring dance to cloud-run-v2,
  compute-vm, folder, kms modules (bigquery-dataset already had it)
- Exclude tag_vars from local.ctx in cloud-run-v2, compute-vm, folder,
  kms, project modules (bigquery-dataset already had it)
- Add tag_vars to context variable in cloud-run-v2, compute-vm modules
  (others already had it)
- Update all context tests with dynamic tag binding values using
  var.context.tag_vars

* docs: add module-level tftest.yaml test instructions to GEMINI.md

* docs: regenerate READMEs after tag-regex alignment

- Regenerate variable tables in 7 module READMEs to reflect
  line number shifts from prior tag-regex changes
- Add tag_vars exclusion to gcs ctx local
- Fix whitespace alignment in iam-service-account and
  project-factory tag_vars blocks
- Update tftest resource counts for organization and project
- Remove tags_dynamic from organization/project output tables

* fix(project-factory): update test inventory for tag_bindings module split

- Move tag binding address from folder-2 to folder-2-iam in test
  inventory (tag_bindings moved from creation to IAM modules)
- Update module instance count from 34 to 35
- Regenerate README tables after terraform fmt line shifts
- Apply terraform fmt to variables.tf

* refactor(project-factory): remove unnecessary depends_on from folder-iam modules

Folder IAM modules depend on their own folder creation modules, not
on module.projects. The explicit depends_on was leftover from an
earlier design.

* FAST stages

* Address review comments.

- FAST Stages:
  - Added tag_keys to output-files.tf in 0-org-setup to pass org tags via tfvars.
  - Sorted tag_keys and tag_values in output-files.tf.
  - Updated project-factory, networking, and security stages to use tag_keys.
  - Filtered tag_keys for dynamic tags only.
- Modules:
  - Excluded tag_vars from local.ctx in iam-service-account and organization.
  - Simplified tag_value in iam-service-account.
- Tests:
  - Updated test inventories for 0-org-setup and project-factory.

* Fix tf format

* Fix tfdoc

* docs: add ADR for templatestring vars convention and update status of base path ADR

* More tfdoc

* Update schemas

* Use endswith in context loop

* Address review

* Update FAST readmes

* Update last modules

* Terraform fmt

* Revert alloydb

* Fix whitespace

---------

Co-authored-by: Ludovico Magnocavallo <ludo@qix.it>
2026-04-24 20:45:45 +00:00

263 lines
7.8 KiB
HCL

/**
* Copyright 2026 Google LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
variable "cleanup_policies" {
description = "Object containing details about the cleanup policies for an Artifact Registry repository."
type = map(object({
action = string
condition = optional(object({
tag_state = optional(string)
tag_prefixes = optional(list(string))
older_than = optional(string)
newer_than = optional(string)
package_name_prefixes = optional(list(string))
version_name_prefixes = optional(list(string))
}))
most_recent_versions = optional(object({
package_name_prefixes = optional(list(string))
keep_count = optional(number)
}))
}))
default = null
}
variable "cleanup_policy_dry_run" {
description = "If true, the cleanup pipeline is prevented from deleting versions in this repository."
type = bool
default = null
}
variable "context" {
description = "Context-specific interpolations."
type = object({
artifact_registries = optional(map(string), {})
condition_vars = optional(map(map(string)), {})
custom_roles = optional(map(string), {})
iam_principals = optional(map(string), {})
kms_keys = optional(map(string), {})
locations = optional(map(string), {})
project_ids = optional(map(string), {})
secrets = optional(map(string), {})
tag_values = optional(map(string), {})
tag_vars = optional(object({
projects = optional(map(map(string)), {})
organization = optional(map(string), {})
}), {})
})
default = {}
nullable = false
}
variable "description" {
description = "An optional description for the repository."
type = string
default = "Terraform-managed registry"
}
variable "enable_vulnerability_scanning" {
description = "Whether vulnerability scanning should be enabled in the repository."
type = bool
default = null
}
variable "encryption_key" {
description = "The KMS key name to use for encryption at rest."
type = string
default = null
}
variable "format" {
description = "Repository format."
type = object({
apt = optional(object({
remote = optional(object({
# custom_repository = optional(string) # still not available in provider
public_repository = string # "BASE path"
disable_upstream_validation = optional(bool)
upstream_credentials = optional(object({
username = string
password_secret_version = string
}))
}))
standard = optional(bool)
}))
docker = optional(object({
remote = optional(object({
public_repository = optional(string)
common_repository = optional(string)
custom_repository = optional(string)
disable_upstream_validation = optional(bool)
upstream_credentials = optional(object({
username = string
password_secret_version = string
}))
}))
standard = optional(object({
immutable_tags = optional(bool)
}))
virtual = optional(map(object({
repository = string
priority = number
})))
}))
kfp = optional(object({
standard = optional(bool)
}))
generic = optional(object({
standard = optional(bool)
}))
go = optional(object({
standard = optional(bool)
}))
googet = optional(object({
standard = optional(bool)
}))
maven = optional(object({
remote = optional(object({
public_repository = optional(string)
custom_repository = optional(string)
disable_upstream_validation = optional(bool)
upstream_credentials = optional(object({
username = string
password_secret_version = string
}))
}))
standard = optional(object({
allow_snapshot_overwrites = optional(bool)
version_policy = optional(string)
}))
virtual = optional(map(object({
repository = string
priority = number
})))
}))
npm = optional(object({
remote = optional(object({
public_repository = optional(string)
custom_repository = optional(string)
disable_upstream_validation = optional(bool)
upstream_credentials = optional(object({
username = string
password_secret_version = string
}))
}))
standard = optional(bool)
virtual = optional(map(object({
repository = string
priority = number
})))
}))
python = optional(object({
remote = optional(object({
public_repository = optional(string)
custom_repository = optional(string)
disable_upstream_validation = optional(bool)
upstream_credentials = optional(object({
username = string
password_secret_version = string
}))
}))
standard = optional(bool)
virtual = optional(map(object({
repository = string
priority = number
})))
}))
yum = optional(object({
remote = optional(object({
# custom_repository = optional(string) # still not available in provider
public_repository = string # "BASE path"
disable_upstream_validation = optional(bool)
upstream_credentials = optional(object({
username = string
password_secret_version = string
}))
}))
standard = optional(bool)
}))
})
nullable = false
validation {
condition = (
length([for k, v in var.format : k if v != null]) == 1
)
error_message = "Multiple or zero formats are not supported."
}
validation {
condition = alltrue([
for k, v in var.format :
length([for kk, vv in v : k if vv != null]) == 1
if v != null
])
error_message = "Repository can only be one of standard, remote or virtual."
}
validation {
condition = alltrue([
for k, v in var.format : (
(try(v.remote.public_repository, null) == null ? 0 : 1) +
(try(v.remote.custom_repository, null) == null ? 0 : 1) +
(try(v.remote.common_repository, null) == null ? 0 : 1)
) == 1
if try(v.remote, null) != null
])
error_message = "Remote repositories must specify exactly one of public_repository, custom_repository and common_repository."
}
}
variable "labels" {
description = "Labels to be attached to the registry."
type = map(string)
default = {}
}
variable "location" {
description = "Registry location. Use `gcloud beta artifacts locations list' to get valid values."
type = string
}
variable "name" {
description = "Registry name."
type = string
}
variable "project_id" {
description = "Registry project id."
type = string
}
variable "tag_bindings" {
description = "Tag bindings for this repository, in key => tag value id format."
type = map(string)
nullable = false
default = {}
}
variable "universe" {
description = "GCP universe where to deploy the project. The prefix will be prepended to the project id."
type = object({
package_domain = string
prefix = string
})
default = null
}