An Item in the EWC Community Hub is a self-contained repository that helps others deploy, configure, or integrate technology using:

• Ansible Playbooks

• Terraform Modules

• Helm Charts

• Or a combination of these

You have full flexibility in structuring your Item — but we recommend checking out existing examples and reusing proven building blocks from the EWC ecosystem.

1. Before You Start

• Think about the purpose of your item — is it deploying infrastructure, configuring software, or bundling tools together?

• Decide which tools fit best:

  • Terraform → Infrastructure provisioning

  • Ansible → Configuration management

  • Helm → Kubernetes application deployment

• Review our EWC shared code to save time and ensure consistency.

2. Look at Example Items

Here are some existing Items you can explore for inspiration:

• Example Terraform Module: [link to example]

• Example Ansible Playbook: [link to example]

• Example Helm Chart: [link to example]

• Hybrid Example (Terraform + Ansible): [link to example]

These will give you ideas for:

• Directory structure

• Documentation style (README.md usage)

• CI/CD workflows

• Dependency management

3. Reuse Shared Building Blocks

The EWC GitHub repo provides common modules, roles, and templates you can integrate into your Item:

Recommended Good Practices

• Documentation: Always include a README.md explaining:

  • Purpose

  • Usage instructions

  • Dependencies

  • Example commands

• Variables & Parameters: Use defaults in Ansible or variables.tf in Terraform to make your item configurable.

• Testing: If possible, add automated tests (e.g., molecule for Ansible, terraform validate, helm lint).

• Licensing: Add a LICENSE file.

• Versioning: Use tags/releases to help others track changes.

5. Submitting Your Item

Once your Item is ready:

1. Host it in a public repository (GitHub, GitLab, etc.)

2. Add it to the Community Hub via our contribution process Using Items in the Community Hub

3. Share it with the community! 🎉