Argo CD Community Resources: Where to Connect, Contribute, and Get Support
The Argo CD community offers monthly user meetings, CNCF Slack channels, GitHub discussions, and community-reviewed design proposals to help users and contributors get support and shape the project's future.
Argo CD is a declarative, GitOps continuous delivery tool for Kubernetes that thrives on active community participation. Whether you're troubleshooting an application deployment or proposing a new feature, knowing where to find Argo CD community resources is essential for success. The project maintains open communication channels and welcomes contributions through its well-documented source code and collaborative review processes.
Architecture Overview and Key Components
Understanding Argo CD's architecture helps you engage effectively with the community when asking questions or submitting contributions. The system consists of loosely coupled, containerized components defined in the cmd/ directory:
argocd-server – The HTTP API gateway and UI backend that authenticates users and serves the web UI. See the implementation in [cmd/argocd-server/commands/argocd_server.go](https://github.com/argoproj/argo-cd/blob/master/cmd/argocd-server/commands/argocd_server.go).
repo-server – Pulls manifests from Git, Helm, Kustomize, and Jsonnet, rendering them to raw Kubernetes objects. It also validates signatures and performs health checks. Reference [cmd/argocd-repo-server/commands/argocd_repo_server.go](https://github.com/argoproj/argo-cd/blob/master/cmd/argocd-repo-server/commands/argocd_repo_server.go).
application-controller – The core control loop that watches Application CRDs, computes diffs between desired and live state, and drives sync operations. Located in [cmd/argocd-application-controller/commands/argocd_application_controller.go](https://github.com/argoproj/argo-cd/blob/master/cmd/argocd-application-controller/commands/argocd_application_controller.go).
applicationset-controller – Generates many Application objects from a single definition using generators like list, matrix, or cluster generators. Found in [cmd/argocd-applicationset-controller/commands/applicationset_controller.go](https://github.com/argoproj/argo-cd/blob/master/cmd/argocd-applicationset-controller/commands/applicationset_controller.go).
notification-controller – Sends alerts to Slack, email, and MS Teams about sync status and health changes. See [cmd/argocd-notification/commands/argocd_notification.go](https://github.com/argoproj/argo-cd/blob/master/cmd/argocd-notification/commands/argocd_notification.go).
Core Concepts for Community Contributors
When participating in Argo CD community resources, you'll encounter these fundamental concepts:
- Application CRD – The declarative description of a deployment containing Git repo URLs, target revisions, and sync policies. Defined in [
pkg/apis/application/v1alpha1/types.go](https://github.com/argoproj/argo-cd/blob/master/pkg/apis/application/v1alpha1/types.go). - Project CRD – Logical groupings of applications that define access policies and resource quotas. See [
pkg/apis/application/v1alpha1/project.go](https://github.com/argoproj/argo-cd/blob/master/pkg/apis/application/v1alpha1/project.go). - Resource Tracking – Uses configurable strategies (labels or annotations) to map live resources back to their originating
Application. - Hooks and Waves – Pre-sync and post-sync hooks that orchestrate complex rollout orders.
Where to Find Argo CD Community Resources
The Argo CD project maintains several official channels for support and collaboration:
CNCF Slack – Join the #argo-cd and #argo-proj channels on the CNCF Slack workspace for real-time help from maintainers and users.
Monthly User Meetings – Regular community meetings provide opportunities to discuss roadmap items, share use cases, and ask questions directly to the maintainers. Check the Community section of the [README.md](https://github.com/argoproj/argo-cd/blob/master/README.md) for the current meeting schedule and calendar links.
GitHub Issues and Discussions – Report bugs, request features, or search existing solutions in the argoproj/argo-cd repository. The community uses "community-reviewed" PRs to ensure changes meet user needs.
Design Proposals – For significant changes, the community follows a proposal process documented in docs/proposals/. This directory contains community-driven design documents for features like server-side apply and multiple-source support.
Quick Start for New Contributors
Before engaging with Argo CD community resources, set up a local instance to understand the system:
# Install Argo CD into the argocd namespace
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/master/manifests/install.yaml
# Expose the API server for local testing
kubectl port-forward svc/argocd-server -n argocd 8080:443
# Log in via CLI (default admin password is the pod name)
ARGOCD_PASSWORD=$(kubectl -n argocd get pod -l app.kubernetes.io/name=argocd-server -o jsonpath="{.items[0].metadata.name}")
argocd login localhost:8080 --username admin --password $ARGOCD_PASSWORD --insecure
# Create a sample application from the community examples
argocd app create guestbook \
--repo https://github.com/argoproj/argocd-example-apps \
--path guestbook \
--dest-server https://kubernetes.default.svc \
--dest-namespace default
# Sync and verify
argocd app sync guestbook
argocd app get guestbook
Contributing to Documentation and Code
The Argo CD community resources include comprehensive documentation in the docs/ directory:
- User Guide – Located in
docs/user-guide/, covering sync options, hooks, and resource tracking. - Helm Charts – Production deployment configurations in
charts/argo-cd/. - UI Development – The React frontend source code lives in
ui/src/, with components like [ui/src/app/applications/components/resources.ts](https://github.com/argoproj/argo-cd/blob/master/ui/src/app/applications/components/resources.ts) handling resource visualization.
Summary
- Argo CD community resources include monthly user meetings, CNCF Slack channels, and GitHub issues for support and collaboration.
- The architecture consists of specialized components like
argocd-serverandapplication-controllerdefined in specificcmd/directories. - Application and Project CRDs are defined in
pkg/apis/application/v1alpha1/and form the core of the GitOps workflow. - Community design proposals are managed in
docs/proposals/for significant feature discussions. - The [
README.md](https://github.com/argoproj/argo-cd/blob/master/README.md) contains the canonical list of community meeting times and contribution guidelines.
Frequently Asked Questions
What is the best way to get help with Argo CD deployment issues?
The CNCF Slack #argo-cd channel provides real-time assistance from experienced users and maintainers. For complex issues, search existing GitHub issues or create a new one with logs from the application-controller and repo-server components.
How can I propose a new feature for Argo CD?
Submit a design proposal in the docs/proposals/ directory following the community guidelines. Major features require discussion at monthly community meetings before implementation to ensure alignment with the project roadmap.
Where can I find the official Argo CD meeting schedule?
The Community section of the repository [README.md](https://github.com/argoproj/argo-cd/blob/master/README.md) lists all recurring meetings, including monthly user groups and contributor office hours. The document also provides links to the community calendar and meeting recordings.
How do I contribute code to the Argo CD project?
Fork the repository and submit pull requests following the "community-reviewed" process. Focus on specific components like the CLI in [cmd/argocd/commands/app.go](https://github.com/argoproj/argo-cd/blob/master/cmd/argocd/commands/app.go) or the API server in [cmd/argocd-server/commands/argocd_server.go](https://github.com/argoproj/argo-cd/blob/master/cmd/argocd-server/commands/argocd_server.go). All changes require maintainer review and CI validation before merging.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" Maintain an open-source project? Get it listed too →