GitOps Status
Monitor GitOps application health and manage sync operations via MCP.
Instructions
Step 1: Overview Dashboard
Call MCP tool: harness_get
Parameters:
resource_type: "gitops_dashboard"
Step 2: List Applications
Call MCP tool: harness_list
Parameters:
resource_type: "gitops_application"
org_id: "<organization>"
project_id: "<project>"
Step 3: Get Application Details
Call MCP tool: harness_get
Parameters:
resource_type: "gitops_application"
resource_id: "<app_name>"
org_id: "<organization>"
project_id: "<project>"
Step 4: Check Resource Tree
Call MCP tool: harness_get
Parameters:
resource_type: "gitops_app_resource_tree"
resource_id: "<app_name>"
Step 5: Get Pod Logs (Debugging)
Call MCP tool: harness_get
Parameters:
resource_type: "gitops_pod_log"
resource_id: "<pod_name>"
Step 6: Check Events
Call MCP tool: harness_list
Parameters:
resource_type: "gitops_app_event"
Step 7: Trigger Sync
Call MCP tool: harness_execute
Parameters:
resource_type: "gitops_application"
action: "sync"
resource_id: "<app_name>"
org_id: "<organization>"
project_id: "<project>"
Additional Resource Types
Call MCP tool: harness_list
Parameters:
resource_type: "gitops_agent" # ArgoCD agents
resource_type: "gitops_cluster" # Connected clusters
resource_type: "gitops_repository" # Git repositories
resource_type: "gitops_applicationset" # ApplicationSets
resource_type: "gitops_managed_resource" # K8s resources
GitOps Resource Types
| Resource Type | Operations | Description |
|---|---|---|
gitops_agent |
list, get | ArgoCD instances |
gitops_application |
list, get, sync | Applications |
gitops_applicationset |
list, get | ApplicationSets |
gitops_cluster |
list, get | K8s clusters |
gitops_repository |
list, get | Git repositories |
gitops_app_event |
list | Application events |
gitops_pod_log |
get | Pod logs |
gitops_managed_resource |
list | K8s resources |
gitops_app_resource_tree |
get | Resource tree |
gitops_dashboard |
get | Overview dashboard |
Application Health States
- Healthy - All resources running and passing health checks
- Degraded - Some resources failing health checks
- Progressing - Resources being created/updated
- Suspended - Application suspended
- Missing - Resources not found
- Unknown - Health status cannot be determined
Sync States
- Synced - Live state matches desired state in Git
- OutOfSync - Live state differs from Git (needs sync)
- Unknown - Sync status cannot be determined
Examples
- "Show me all GitOps applications" - List gitops_application
- "Is the api-gateway in sync?" - Get gitops_application, check sync status
- "Sync the payment-service" - Execute sync action
- "Get pod logs for failing service" - Get gitops_pod_log
- "Show the resource tree for my app" - Get gitops_app_resource_tree
Performance Notes
- Check all applications in the requested scope before summarizing health status.
- For out-of-sync applications, examine the resource tree to identify the specific drift.
- Gather pod logs for failing resources before diagnosing issues.
Troubleshooting
Application OutOfSync
- Check git repo for recent changes
- Verify auto-sync is enabled if expected
- Review sync errors in events
- Trigger manual sync if needed
Application Degraded
- Check pod logs for application errors
- Review resource tree for failing pods
- Check resource limits and quotas
Agent Not Connected
- Verify ArgoCD agent is running
- Check network connectivity
- Review agent configuration