https://github.com/netascode/terraform-utils-nac-merge

https://github.com/netascode/terraform-utils-nac-merge

Last synced: 17 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/netascode/terraform-utils-nac-merge
• Owner: netascode
• License: apache-2.0
• Archived: true
• Created: 2023-01-18T08:23:22.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-02-10T12:04:44.000Z (over 1 year ago)
• Last Synced: 2025-03-21T18:04:19.592Z (2 months ago)
• Language: HCL
• Size: 38.1 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        

[![Tests](https://github.com/netascode/terraform-utils-nac-merge/actions/workflows/test.yml/badge.svg)](https://github.com/netascode/terraform-utils-nac-merge/actions/workflows/test.yml)

# Terraform Merge Module

A Terraform module to merge the content of several YAML files into a single Terraform data structure.

This module is part of the Cisco [*Nexus as Code*](https://cisco.com/go/nexusascode) project. Its goal is to allow users to instantiate network fabrics in minutes using an easy to use, opinionated data model. It takes away the complexity of having to deal with references, dependencies or loops. By completely separating data (defining variables) from logic (infrastructure declaration), it allows the user to focus on describing the intended configuration while using a set of maintained and tested Terraform Modules without the need to understand the low-level ACI object model. More information can be found here: https://cisco.com/go/nexusascode.

A comprehensive example using this module is available here: https://github.com/netascode/nac-aci-comprehensive-example

## Examples

```hcl

module "nac_merge" {

  source  = "netascode/nac-merge/utils"

  version = ">= 0.1.0"

  yaml_strings = [

    "root:\n  child1: value1",

    "root:\n  child2: value2"

  ]

}

## Requirements

| Name | Version |

|------|---------|

|  [terraform](#requirement\_terraform) | >= 1.0.0 |

|  [utils](#requirement\_utils) | >= 0.2.4 |

## Providers

| Name | Version |

|------|---------|

|  [utils](#provider\_utils) | >= 0.2.4 |

## Inputs

| Name | Description | Type | Default | Required |

|------|-------------|------|---------|:--------:|

|  [yaml\_strings](#input\_yaml\_strings) | List of YAML strings to be merged into a single model. | `list(string)` | n/a | yes |

## Outputs

| Name | Description |

|------|-------------|

|  [model](#output\_model) | Model data. |

|  [defaults](#output\_defaults) | Default values. |

## Resources

| Name | Type |

|------|------|

| [utils_yaml_merge.defaults](https://registry.terraform.io/providers/netascode/utils/latest/docs/data-sources/yaml_merge) | data source |

| [utils_yaml_merge.model](https://registry.terraform.io/providers/netascode/utils/latest/docs/data-sources/yaml_merge) | data source |