agent

command
v0.4.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 31, 2021 License: Apache-2.0 Imports: 21 Imported by: 0

README

GitOps Agent

The GitOps Agent leverages the GitOps Engine and provides access to many engine features via a simple CLI interface. The agent provides the same set of core features as Argo CD including basic reconciliation, syncing as well as sync hooks and sync waves.

The main difference is that the agent is syncing one Git repository into the same cluster where it is installed.

Quick Start

By default the agent is configured to use manifests from guestbook directory in https://github.com/argoproj/argocd-example-apps repository.

The agent supports two modes:

  • namespaced mode - agent manages the same namespace where it is installed
  • full cluster mode - agent manages the whole cluster
Namespaced Mode

Install the agent with the default settings using the command below. Done!

kubectl apply -f https://raw.githubusercontent.com/argoproj/gitops-engine/master/agent/manifests/install-namespaced.yaml 
kubectl rollout status deploy/gitops-agent

The the agent logs:

kubectl logs -f deploy/gitops-agent gitops-agent

Find the guestbook deployment in the current K8S namespace:

kubectl get deployment
Cluster Mode

The cluster mode grants full cluster access to the GitOps Agent. Use the following command to install an agent into the gitops-agent namespace and use it to manage resources in any cluster namespace.

Note. In cluster mode agents gets full cluster access. See gitops-agent-cluster-role.yaml definition for more information.

kubectl create ns gitops-agent
kubectl apply -f https://raw.githubusercontent.com/argoproj/gitops-engine/master/agent/manifests/install.yaml -n gitops-agent
Customize Git Repository

The agent runs git-sync as a sidecar container to access the repository. Update the container env variables to change the repository.

Demo Recording

asciicast

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL