mirror of
https://github.com/wshobson/agents.git
synced 2026-03-18 09:37:15 +00:00
65e5cb093a
- Add 47 Agent Skills across 14 plugins following Anthropic's specification - Python (5): async patterns, testing, packaging, performance, UV package manager - JavaScript/TypeScript (4): advanced types, Node.js patterns, testing, modern JS - Kubernetes (4): manifests, Helm charts, GitOps, security policies - Cloud Infrastructure (4): Terraform, multi-cloud, hybrid networking, cost optimization - CI/CD (4): pipeline design, GitHub Actions, GitLab CI, secrets management - Backend (3): API design, architecture patterns, microservices - LLM Applications (4): LangChain, prompt engineering, RAG, evaluation - Blockchain/Web3 (4): DeFi protocols, NFT standards, Solidity security, Web3 testing - Framework Migration (4): React, Angular, database, dependency upgrades - Observability (4): Prometheus, Grafana, distributed tracing, SLO - Payment Processing (4): Stripe, PayPal, PCI compliance, billing - API Scaffolding (1): FastAPI templates - ML Operations (1): ML pipeline workflow - Security (1): SAST configuration - Restructure documentation into /docs directory - agent-skills.md: Complete guide to all 47 skills - agents.md: All 85 agents with model configuration - plugins.md: Complete catalog of 63 plugins - usage.md: Commands, workflows, and best practices - architecture.md: Design principles and patterns - Update README.md - Add Agent Skills banner announcement - Reduce length by ~75% with links to detailed docs - Add What's New section showcasing Agent Skills - Add Popular Use Cases with real examples - Improve navigation with Core Guides and Quick Links - Update marketplace.json with skills arrays for 14 plugins All 47 skills follow Agent Skills Specification: - Required YAML frontmatter (name, description) - Use when activation clauses - Progressive disclosure architecture - Under 1024 character descriptions
135 lines
2.8 KiB
Markdown
135 lines
2.8 KiB
Markdown
# ArgoCD Setup and Configuration
|
|
|
|
## Installation Methods
|
|
|
|
### 1. Standard Installation
|
|
```bash
|
|
kubectl create namespace argocd
|
|
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
|
|
```
|
|
|
|
### 2. High Availability Installation
|
|
```bash
|
|
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/ha/install.yaml
|
|
```
|
|
|
|
### 3. Helm Installation
|
|
```bash
|
|
helm repo add argo https://argoproj.github.io/argo-helm
|
|
helm install argocd argo/argo-cd -n argocd --create-namespace
|
|
```
|
|
|
|
## Initial Configuration
|
|
|
|
### Access ArgoCD UI
|
|
```bash
|
|
# Port forward
|
|
kubectl port-forward svc/argocd-server -n argocd 8080:443
|
|
|
|
# Get initial admin password
|
|
argocd admin initial-password -n argocd
|
|
```
|
|
|
|
### Configure Ingress
|
|
```yaml
|
|
apiVersion: networking.k8s.io/v1
|
|
kind: Ingress
|
|
metadata:
|
|
name: argocd-server-ingress
|
|
namespace: argocd
|
|
annotations:
|
|
cert-manager.io/cluster-issuer: letsencrypt-prod
|
|
nginx.ingress.kubernetes.io/ssl-passthrough: "true"
|
|
nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
|
|
spec:
|
|
ingressClassName: nginx
|
|
rules:
|
|
- host: argocd.example.com
|
|
http:
|
|
paths:
|
|
- path: /
|
|
pathType: Prefix
|
|
backend:
|
|
service:
|
|
name: argocd-server
|
|
port:
|
|
number: 443
|
|
tls:
|
|
- hosts:
|
|
- argocd.example.com
|
|
secretName: argocd-secret
|
|
```
|
|
|
|
## CLI Configuration
|
|
|
|
### Login
|
|
```bash
|
|
argocd login argocd.example.com --username admin
|
|
```
|
|
|
|
### Add Repository
|
|
```bash
|
|
argocd repo add https://github.com/org/repo --username user --password token
|
|
```
|
|
|
|
### Create Application
|
|
```bash
|
|
argocd app create my-app \
|
|
--repo https://github.com/org/repo \
|
|
--path apps/my-app \
|
|
--dest-server https://kubernetes.default.svc \
|
|
--dest-namespace production
|
|
```
|
|
|
|
## SSO Configuration
|
|
|
|
### GitHub OAuth
|
|
```yaml
|
|
apiVersion: v1
|
|
kind: ConfigMap
|
|
metadata:
|
|
name: argocd-cm
|
|
namespace: argocd
|
|
data:
|
|
url: https://argocd.example.com
|
|
dex.config: |
|
|
connectors:
|
|
- type: github
|
|
id: github
|
|
name: GitHub
|
|
config:
|
|
clientID: $GITHUB_CLIENT_ID
|
|
clientSecret: $GITHUB_CLIENT_SECRET
|
|
orgs:
|
|
- name: my-org
|
|
```
|
|
|
|
## RBAC Configuration
|
|
```yaml
|
|
apiVersion: v1
|
|
kind: ConfigMap
|
|
metadata:
|
|
name: argocd-rbac-cm
|
|
namespace: argocd
|
|
data:
|
|
policy.default: role:readonly
|
|
policy.csv: |
|
|
p, role:developers, applications, *, */dev, allow
|
|
p, role:operators, applications, *, */*, allow
|
|
g, my-org:devs, role:developers
|
|
g, my-org:ops, role:operators
|
|
```
|
|
|
|
## Best Practices
|
|
|
|
1. Enable SSO for production
|
|
2. Implement RBAC policies
|
|
3. Use separate projects for teams
|
|
4. Enable audit logging
|
|
5. Configure notifications
|
|
6. Use ApplicationSets for multi-cluster
|
|
7. Implement resource hooks
|
|
8. Configure health checks
|
|
9. Use sync windows for maintenance
|
|
10. Monitor with Prometheus metrics
|