kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v2.8.0/manifests/install.yaml

namespace/argocd created
secret/argocd-secret created
serviceaccount/argocd-server created
deployment.apps/argocd-server created
... (другие ресурсы)

Ошибка: ErrImagePull / ImagePullBackOff
Причина: ноды не имеют доступа к реестру образов или нет разрешений.
Фикс: проверьте интернет/registry credentials, выполните на ноде:
  docker pull argoproj/argocd:v2.8.0
  kubectl describe pod -n argocd <имя-pod>
Если используется приватный реестр — добавьте imagePullSecrets в ServiceAccount.

kubectl -n argocd port-forward svc/argocd-server 8080:443 &
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 --decode

Forwarding from 127.0.0.1:8080 -> 443
admin
# пароль: примерная строка base64 декодированная

Error: address already in use
Фикс: закройте приложение, слушающее порт 8080, или используйте другой порт: 8443:443
  kubectl -n argocd port-forward svc/argocd-server 8443:443 &

mkdir -p repo/apps/my-service
cat > repo/apps/my-service/Chart.yaml <<'EOF'
apiVersion: v2
name: my-service
version: 0.1.0
EOF

cat > repo/apps/my-service/values.yaml <<'EOF'
image:
  repository: myregistry/my-service
  tag: v1.0.0
replicaCount: 2
EOF

mkdir -p repo/base
cat > repo/base/deployment.yaml <<'EOF'
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-service
spec:
  replicas: 2
  selector:
    matchLabels:
      app: my-service
  template:
    metadata:
      labels:
        app: my-service
    spec:
      containers:
      - name: my-service
        image: myregistry/my-service:v1.0.0
        ports:
        - containerPort: 8080
EOF

git init
git add .
git commit -m "initial: add my-service manifests"
git remote add origin git@github.com:example/argocd-repo.git
git push -u origin main

Ошибка: git push — permission denied (publickey)
Причина: SSH-ключ не добавлен в аккаунт GitHub/GitLab.
Фикс: добавьте ваш публичный ключ в настройки аккаунта или используйте HTTPS remote:
  git remote set-url origin https://github.com/your/repo.git

cat > app.yaml <<'EOF'
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: my-service
  namespace: argocd
spec:
  project: default
  source:
    repoURL: 'https://github.com/your/repo.git'
    path: 'base'
    targetRevision: main
  destination:
    server: 'https://kubernetes.default.svc'
    namespace: default
  syncPolicy: {}
EOF

kubectl apply -f app.yaml

application.argoproj.io/my-service created

Ошибка: repository not reachable / unauthorized
Причина: репозиторий приватный или URL указан неверно.
Фикс: добавьте репозиторий через Argo CD CLI или UI с credentials:
  argocd repo add https://github.com/your/repo.git --username --password

kubectl patch application my-service -n argocd --type='merge' -p '{"spec":{"syncPolicy":{"automated":{"prune":true,"selfHeal":true}}}}'

application.argoproj.io/my-service patched

argocd app get my-service
Name:               my-service
Project:            default
Sync Policy:        Automated (Prune, SelfHeal)
Sync Status:        Synced to main (abc123)
Health Status:      Healthy

Ошибка: sync failed — resources not found / invalid manifest
Причина: манифесты содержат синтаксические ошибки или ссылка на несуществующий CRD.
Фикс: проверьте манифесты локально:
  kubectl apply --dry-run=client -f base/deployment.yaml
  kubectl api-resources | grep Если CRD отсутствует — установите CRD в кластер до синка.

kubectl -n argocd patch configmap argocd-rbac-cm -p '{"data":{"policy.csv":"g, dev-team, role:admin\

Argo CD: GitOps для Kubernetes 2026 | KtoHto

Argo CD: GitOps для Kubernetes 2026

Комментарии (0)

Что вы изучите

Требования

Что такое GitOps?

Шаг 1: установка Argo CD

Доступ к UI и argocd CLI

Шаг 2: application manifests

Создание Application в Argo CD

Шаг 3: sync policies

Шаг 4: RBAC и SSO