> For the complete documentation index, see [llms.txt](https://docs.heeler.com/mrecEO40m5D6bt7Pq5pE/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.heeler.com/mrecEO40m5D6bt7Pq5pE/get-started/map-your-organization/environments.md).

# Environments

Assign cloud accounts, projects, and clusters to environment boundaries so Heeler prioritizes findings by real business impact.

Environment boundaries tell Heeler which resources are Production versus Sandbox — the single biggest lever on **risk prioritization**. Once set, environments are maintained automatically and drive both prioritization and Heeler's lifecycle tracking of a fix across every environment.

## Before you start

Environments map from your [connected clouds](/mrecEO40m5D6bt7Pq5pE/get-started/cloud-and-runtime.md) — connect AWS, Azure, GCP, or Kubernetes first, then assign their accounts and clusters here. Without a connected cloud there are no accounts, OUs, or clusters to assign.

## The environments Heeler recognizes

<table><thead><tr><th width="200">Environment</th><th>What it is</th><th width="130">Impact</th></tr></thead><tbody><tr><td><strong>Production</strong></td><td>Runs apps that serve end users and customers.</td><td>High</td></tr><tr><td><strong>Disaster Recovery</strong></td><td>Mitigates disruption or loss of primary environments.</td><td>High</td></tr><tr><td><strong>Corporate</strong></td><td>Internal/company-facing apps (HR, corporate sites).</td><td>High</td></tr><tr><td><strong>Unassigned</strong></td><td>Catch-all for resources not yet curated — treated as High since they could be Production.</td><td>High</td></tr><tr><td><strong>Staging</strong></td><td>Pre-production validation on production-equivalent infra.</td><td>Low</td></tr><tr><td><strong>Development</strong></td><td>Where developers integrate code.</td><td>Low</td></tr><tr><td><strong>Test</strong></td><td>QA / acceptance / performance testing.</td><td>Low</td></tr><tr><td><strong>Sandbox</strong></td><td>Proof-of-concept and experimentation.</td><td>Low</td></tr></tbody></table>

Heeler groups these into **High** and **Low** impact, which flows directly into how findings are prioritized.

<figure><img src="https://414480750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXP3dp2kecwKA2KvYkntz%2Fuploads%2Fgit-blob-99340ac432c0c369571a4210bc0f20d5b8b9052a%2Fcc-gs-map-environments.png?alt=media" alt="Connection Mapping → Environments, showing environment boundaries with impact badges and organizational-unit, account, and tag assignments per cloud provider."><figcaption><p>Environment boundaries per cloud provider, each with its business-impact weighting and assigned accounts.</p></figcaption></figure>

## Ways to assign environments

Choose the method that matches how your cloud is organized (**Administration → Connection Mapping → Environments**, then pick a method under an environment such as Production):

<table><thead><tr><th width="220">Method</th><th>When to use it</th></tr></thead><tbody><tr><td><strong>Organizational Units / Folders</strong> (recommended)</td><td>Simplest to maintain — assign OUs (AWS) or folders (GCP) and every account/resource beneath inherits the environment. Scales as accounts are added.</td></tr><tr><td><strong>Accounts</strong></td><td>Assign whole accounts/projects when they're stable, manageable in number, and consistent in purpose. An account setting takes precedence over its OU.</td></tr><tr><td><a href="/mrecEO40m5D6bt7Pq5pE/get-started/map-your-organization/environments/using-account-level-tags.md"><strong>Account-Level Tags</strong></a></td><td>Map existing account/project tags to environments — good when your structure doesn't reflect environments but your tagging does.</td></tr><tr><td><a href="/mrecEO40m5D6bt7Pq5pE/get-started/map-your-organization/environments/using-resource-level-tags.md"><strong>Resource-Level Tags</strong></a></td><td>Finest control — tag individual compute resources when different environments share an account.</td></tr><tr><td><strong>Kubernetes Clusters</strong></td><td>Assign an environment to each cluster individually.</td></tr></tbody></table>

<figure><img src="https://414480750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXP3dp2kecwKA2KvYkntz%2Fuploads%2Fgit-blob-0e453c9e122486e964ceaa229b54b6c715714e46%2Fcc-cloud-env-02.png?alt=media" alt="The Environments assignment interface for selecting Organizational Units, Accounts, or Tags per environment."><figcaption><p>Assign OUs, accounts, or tags to each environment.</p></figcaption></figure>

{% hint style="info" %}
When you pick **Tags**, the **Allow Resource Override** checkbox decides the precedence: unchecked applies account tags to all their resources; checked lets a [resource-level tag](/mrecEO40m5D6bt7Pq5pE/get-started/map-your-organization/environments/using-resource-level-tags.md) override its account's environment.

<img src="https://414480750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXP3dp2kecwKA2KvYkntz%2Fuploads%2Fgit-blob-dc6f7fa15d5de14d07d5505bff75297a463d1939%2Fcc-cloud-env-03.png?alt=media" alt="The Tags modal, with Allow Resource Override." data-size="original">
{% endhint %}

## Verify

1. On **Connection Mapping → Environments**, each assigned account, project, or cluster shows the **environment badge** you gave it (e.g. Production, Staging).
2. Nothing you intend to curate is left **Unassigned** — anything still Unassigned is treated as High impact until you assign it.
3. Spot-check a repository or service in the [Catalog](/mrecEO40m5D6bt7Pq5pE/catalog.md): its business impact reflects the environment you assigned.

## Related

* [Using Account-Level Tags](/mrecEO40m5D6bt7Pq5pE/get-started/map-your-organization/environments/using-account-level-tags.md) — map account/OU tags to environments.
* [Using Resource-Level Tags](/mrecEO40m5D6bt7Pq5pE/get-started/map-your-organization/environments/using-resource-level-tags.md) — override at the individual-resource level.
* [Map Your Organization](/mrecEO40m5D6bt7Pq5pE/get-started/map-your-organization.md) — teams, applications, and ticketing.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.heeler.com/mrecEO40m5D6bt7Pq5pE/get-started/map-your-organization/environments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
