> For the complete documentation index, see [llms.txt](https://sungwook-choi.gitbook.io/argocd/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sungwook-choi.gitbook.io/argocd/multi-cluster/undefined.md).

# 클러스터 추가

{% hint style="info" %}
참고자료: <https://argo-cd.readthedocs.io/en/stable/operator-manual/declarative-setup/#clusters>
{% endhint %}

## 개요

argo CD는 여러 클러스터를 대상으로 git의 리소스를 sync할 수 있습니다. default 클러스터는argocd가 설치된 클러스터입니다.

<figure><img src="https://419555476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOI7SkWblrvyvFgQ1YM6d%2Fuploads%2FzHQjRQHpt7KTP5ttsYdv%2Fimage.png?alt=media&amp;token=dce32e47-e7be-4aab-ad4e-9c851767d67a" alt=""><figcaption></figcaption></figure>

## 클러스터 추가

2가지 방법(token, 인증서)으로 클러스터를 추가할 수 있습니다.

### Token 설정

```yaml
apiVersion: v1
kind: Secret
metadata:
  name: mycluster-secret
  namespace: argocd
  labels:
    argocd.argoproj.io/secret-type: cluster
type: Opaque
stringData:
  name: mycluster.com
  server: https://mycluster.com
  config: |
    {
      "bearerToken": "<authentication token>"
    }
```

### 인증서 설정

```yaml
apiVersion: v1
kind: Secret
metadata:
  name: mycluster-secret
  namespace: argocd
  labels:
    argocd.argoproj.io/secret-type: cluster
type: Opaque
stringData:
  name: mycluster.com
  server: https://mycluster.com
  config: |
    {
      "tlsClientConfig": {
        "insecure": false,
        "caData": "<base64 encoded certificate>",
        "certData": "<base64 encoded certificate>",
        "keyData": "<base64 encoded key>"
      }      
    }
```

## 클러스터 확인

<figure><img src="https://419555476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOI7SkWblrvyvFgQ1YM6d%2Fuploads%2FnELvBVbj49Rn9dNN1NSW%2Fimage.png?alt=media&amp;token=a558642a-62b9-45a3-8ec6-255bb26e1aaf" alt=""><figcaption></figcaption></figure>

<mark style="color:red;">추가한 클러스터에 argo cd application을 한번도 생성하지 않으면 Unknown상태일 수 있습니다</mark>. 그러므로, 클러스터가 잘 설정되었는지 확인하려면, 클러스터 추가 후 argo cd application을 생성해보세요.

<figure><img src="https://419555476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOI7SkWblrvyvFgQ1YM6d%2Fuploads%2Ftu0Oihehgiy0E56JMwDZ%2Fimage.png?alt=media&amp;token=fbc0ad83-a704-4e9d-8ddf-3dce1f15689a" alt=""><figcaption></figcaption></figure>
