Agent skill
reliability-patterns
Build resilient event systems with retry strategies, dead letter queues, and EventBus persistence. Handle failures gracefully in production deployments.
Install this agent skill to your Project
npx add-skill https://github.com/adaptive-enforcement-lab/claude-skills/tree/main/plugins/patterns/skills/reliability-patterns
SKILL.md
Reliability Patterns
When to Use This Skill
Production event systems must handle failures gracefully. Network blips, service outages, and malformed events are inevitable. These patterns ensure events don't get lost and systems recover automatically. For the complete reference, see the official Argo Events reliability docs.
Implementation
See the full implementation guide in the source documentation.
Techniques
Reliability Architecture
Multiple layers of protection prevent event loss:
flowchart TD
A[Event Arrives] --> B[EventSource Retry]
B -->|Success| C[EventBus Persistence]
C --> D[Sensor Processing]
D -->|Trigger Fails| E[Trigger Retry]
E -->|Exhausted| F[Dead Letter Queue]
D -->|Success| G[Action Complete]
%% Ghostty Hardcore Theme
style A fill:#65d9ef,color:#1b1d1e
style B fill:#fd971e,color:#1b1d1e
style C fill:#515354,color:#f8f8f3
style D fill:#f92572,color:#1b1d1e
style E fill:#9e6ffe,color:#1b1d1e
style F fill:#f92572,color:#1b1d1e
style G fill:#a7e22e,color:#1b1d1e
Reliability Patterns
| Pattern | Purpose | Complexity |
|---|---|---|
| Retry Strategies | Handle transient failures | Low |
| Dead Letter Queues | Capture failed events | Medium |
| Backpressure Handling | Prevent overload | Medium |
Quick Example: Trigger Retry
Add retry logic to handle transient failures:
triggers:
- template:
name: deploy-with-retry
argoWorkflow:
operation: submit
source:
resource:
# ...
retryStrategy:
steps: 3
duration: 10s
factor: 2
jitter: 0.1
This retries failed triggers up to 3 times with exponential backoff:
- First retry: ~10 seconds
- Second retry: ~20 seconds
- Third retry: ~40 seconds
The jitter adds randomness to prevent thundering herd.
EventBus Durability
The EventBus provides at-least-once delivery. Events persist until acknowledged:
apiVersion: argoproj.io/v1alpha1
kind: EventBus
metadata:
name: default
spec:
jetstream:
version: "2.9.11"
persistence:
accessMode: ReadWriteOnce
storageClassName: standard
volumeSize: 10Gi
replicas: 3
With persistence enabled, events survive EventBus pod restarts. The 3-replica configuration provides high availability.
At-Least-Once Semantics
Argo Events guarantees at-least-once delivery, not exactly-once. Your workflows must be idempotent - processing the same event twice should produce the same result. See Idempotency Patterns for implementation strategies.
Related
- Retry Strategies - Transient failure handling
- Dead Letter Queues - Failed event capture
- EventBus Configuration - Persistence setup
- High Availability - Production HA architecture
- Official Reliability Docs - Complete reference
Examples
See examples.md for code examples.
Related Patterns
- Retry Strategies
- Dead Letter Queues
- EventBus Configuration
- High Availability
- Official Reliability Docs
References
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
github-token-permissions-overview
Understanding GITHUB_TOKEN scope, default permissions, and implementing least-privilege principle for GitHub Actions workflows.
secure
Find and fix security issues before they become incidents. Vulnerability scanning, SBOM generation, supply chain security, and secure authentication workflows.
complete-workflow-examples
Copy-paste hardened CI/CD workflows with SHA-pinned actions, minimal GITHUB_TOKEN permissions, OIDC authentication, and comprehensive security scanning for GitHub Actions.
ephemeral-runner-patterns
Disposable runner patterns for GitHub Actions. Container-based, VM-based, and ARC deployment strategies with complete state isolation between jobs.
action-pinning-overview
Why pinning GitHub Actions to SHA-256 commits matters for supply chain security. Attack vectors from unpinned actions and comparison of tag vs SHA pinning.
github-actions-security-patterns-hub
Complete security patterns for GitHub Actions covering action pinning, GITHUB_TOKEN permissions, third-party action risks, secret management, and runner security.
Didn't find tool you were looking for?