Team Administration
The Administration page is the configuration heart of a Team Workspace. Access to this page is restricted strictly to users with the DevOps, Admin, or Owner roles.
1. GitHub Configurations
DeployClear is built around GitOps. While you can write Blocks directly into the dashboard editor, hooking up a GitHub repository is vastly superior for tracking pull requests, peer reviews, and change histories.
- Install the DeployClear GitHub Application via the overarching
Integrationspage. - In the Team Administration page, select Edit Repository.
- Pick a branch containing your Terraform blocks.
- Define your
Glob Pattern. DeployClear walks your directory tree checking any folder matching this pattern for amanifest.yaml. - When a commit hits the target branch, a webhook triggers DeployClear to sync all matching directories and update the corresponding Blocks.
2. Terraform State Management
Because DeployClear acts as an ephemeral execution environment, it is not a data-store for your .tfstate files. You must instruct DeployClear on where it can securely push and pull your state.
In the Administration panel, go to State Configuration.
DeployClear utilizes the standard HTTP backend:
- Backend URL: The REST endpoint for your
.tfstate. - Lock URL: The endpoint for acquiring an optimistic lock (Crucial for preventing concurrent deployment races).
- Unlock URL: The endpoint for releasing the state lock.
- Headers / Credentials: Any required Basic Auth or Bearer tokens.
Once saved, DeployClear injects a hidden backend.tf block automatically during the Init phase of every Job.
State Export
While deploying, if you need to run terraform import or debug a stuck lock, you can export your raw state file and variables directly from the Administration page.
Sensitive State
Exported Terraform state files contain all variables (including Secrets) in plaintext. Handle exported state files with the utmost operational security. Only Admins and Owners can perform state exports.