$ tsh login --proxy= --user=
$ tctl status
# Cluster  (=teleport.url=)
# Version  (=teleport.version=)
# CA pin   (=presets.ca_pin=)

$ sudo teleport-update enable

$ sudo apt remove teleport-ent-updater

$ sudo teleport-update uninstall

$ sudo teleport-update enable --overwrite

$ sudo systemctl disable machineid --now

$ sudo systemctl enable tbot --now

$ tar xf teleport-update-[version].tgz
$ cd teleport-update-[version]
$ sudo ./teleport-update enable --proxy example.teleport.sh

$ sudo systemctl enable teleport --now

$ sudo systemctl enable tbot --now

kind: autoupdate_config
metadata:
  name: autoupdate-config
spec:
  agents:
    mode: enabled
    strategy: halt-on-error
    schedules:
      regular:
        - name: default
          days: [ "Mon", "Tue", "Wed", "Thu" ]
          # start_hour은 UTC 기준
          start_hour: 16

kind: autoupdate_config
metadata:
  name: autoupdate-config
spec:
  agents:
    mode: enabled
    strategy: halt-on-error
    schedules:
      regular:
        - name: staging
          days: [ "Mon", "Tue", "Wed", "Thu" ]
          start_hour: 4
        - name: production
          days: [ "Mon", "Tue", "Wed", "Thu" ]
          start_hour: 5
          wait_hours: 24

kind: autoupdate_version
metadata:
  name: autoupdate-version
spec:
  agents:
    start_version: 17.2.0
    target_version: 17.2.1
    schedule: regular
    mode: enabled

$ tctl create -f autoupdate_version.yaml

$ tctl autoupdate agents status
Agent autoupdate mode: enabled
Rollout creation date: 2025-03-10 15:01:45
Start version: 1.2.3
Target version: 1.2.4
Rollout state: Active
Strategy: halt-on-error

Group Name State     Start Time          State Reason
---------- --------- ------------------- ------------------------
dev        Active    2025-03-11 12:00:10 can_start
stage      Unstarted                     previous_groups_not_done
prod       Unstarted                     previous_groups_not_done

Commands:
  autoupdate agents status       에이전트 자동 업데이트 상태를 출력합니다.
  autoupdate agents report       에이전트 자동 업데이트 보고서를 집계하고 버전별 및 업데이트 그룹별 에이전트 수를 표시합니다.
  autoupdate agents start-update 하나 이상의 그룹 업데이트를 시작합니다.
  autoupdate agents mark-done    하나 이상의 그룹을 업데이트 완료로 표시합니다.
  autoupdate agents rollback     하나 이상의 그룹을 롤백합니다.

$ tctl autoupdate agents start-update stage prod
Started updating agents groups: [stage prod].
New agent rollout status:

Group Name State     Start Time          State Reason
---------- --------- ------------------- --------------
dev        Unstarted                     cannot_start
stage      Active    2025-03-10 15:04:16 manual_trigger
prod       Active    2025-03-10 15:04:16 manual_trigger

$ tctl inventory ls --upgrader=none
Server ID                            Hostname      Services Version Upgrader
------------------------------------ ------------- -------- ------- --------
00000000-0000-0000-0000-000000000000 ip-10-1-6-130 Node     v14.4.5 none
...

$ tctl inventory ls --upgrader=unit
Server ID                            Hostname      Services Version Upgrader
------------------------------------ ------------- -------- ------- --------
00000000-0000-0000-0000-000000000000 ip-10-1-6-131 Node     v14.4.5 unit
...

$ sudo apt remove teleport-ent-updater

$ sudo yum remove teleport-ent-updater

$ sudo mkdir -p /etc/teleport-upgrade.d/
$ sudo touch /etc/teleport-upgrade.d/schedule
$ sudo chown your-teleport-user /etc/teleport-upgrade.d/schedule

Kubernetes 에이전트를 관리형 업데이트에 등록#

이 섹션은 teleport-kube-agent 릴리즈 이름이 teleport-agent이고 teleport 네임스페이스에 설치되어 있다고 가정합니다.

1. teleport-kube-agent 차트의 values 파일에 다음 차트 값을 추가합니다:

   updater:
     enabled: true
   

2. teleport-kube-agent 차트의 새 버전을 포함하도록 Teleport Helm 저장소를 업데이트합니다:

   $ helm repo update teleport
   

3. 새 값으로 Helm 차트 릴리즈를 업데이트합니다:

   Cloud-HostedSelf-Hosted

$ helm -n   upgrade  teleport/teleport-kube-agent \
--values=values.yaml \
--version="(=cloud.version=)"

$ helm -n   upgrade  teleport/teleport-kube-agent \
--values=values.yaml \
--version="(=teleport.version=)"

1. 업데이터의 파드가 준비 상태인지 확인하여 업데이터가 올바르게 실행되고 있는지 검증할 수 있습니다:

   $ kubectl -n teleport-agent get pods
   NAME                               READY   STATUS    RESTARTS   AGE
   <your-agent-release>-0                         1/1     Running   0          14m
   <your-agent-release>-1                         1/1     Running   0          14m
   <your-agent-release>-2                         1/1     Running   0          14m
   <your-agent-release>-updater-d9f97f5dd-v57g9   1/1     Running   0          16m
   

2. 업데이터 로그를 확인하여 배포 문제를 확인합니다:

   $ kubectl -n  logs deployment/-updater
   2023-04-28T13:13:30Z	INFO	StatefulSet is already up-to-date, not updating.	{"controller": "statefulset", "controllerGroup": "apps", "controllerKind": "StatefulSet", "StatefulSet": {"name":"my-agent","namespace":"agent"}, "namespace": "agent", "name": "my-agent", "reconcileID": "10419f20-a4c9-45d4-a16f-406866b7fc05", "namespacedname": "agent/my-agent", "kind": "StatefulSet", "err": "no new version (current: \"v12.2.3\", next: \"v12.2.3\")"}
   

GitOps 도구#

Kubernetes 에이전트의 관리형 업데이트는 지속적 배포를 위한 GitOps 도구와 함께 사용할 때 해결 방법이 필요합니다. teleport-kube-agent Helm 차트가 teleport-agent 리소스의 버전을 소유하므로 teleport-agent-updater가 teleport-agent 리소스의 이미지 버전을 수정하면 GitOps 도구가 teleport-agent 리소스에서 드리프트 또는 차이점을 감지합니다.

아래 섹션에서는 다양한 GitOps 도구에 대한 해결 방법을 설명합니다.

ArgoCD 배포#

관리형 업데이트 후 ArgoCD는 teleport-agent 리소스를 OutOfSync로 보고합니다. 이 문제를 해결하기 위해 Diff 사용자 정의를 사용하여 이미지 버전의 차이를 무시하세요. 다음은 이름 teleport-agent 및 네임스페이스 teleport를 사용하는 배포 예시입니다.

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: teleport-agent
  namespace: teleport
spec:
  ignoreDifferences:
    - group: apps
      kind: StatefulSet
      name: teleport-agent
      namespace: teleport
      jqPathExpressions:
        - .spec.template.spec.containers[] | select(.name == "teleport").image
...

FluxCD 배포#

관리형 업데이트 후 FluxCD는 DriftDetected 이벤트를 보고합니다. 이 문제를 해결하기 위해 드리프트 감지 구성을 수정하여 이미지 버전의 차이를 무시하세요. 다음은 이름 teleport-agent 및 네임스페이스 teleport를 사용하는 배포 예시입니다.

apiVersion: helm.toolkit.fluxcd.io/v2beta2
kind: HelmRelease
metadata:
  name: teleport-agent
  namespace: teleport
spec:
  driftDetection:
    mode: enabled
    ignore:
      - paths: [ "/spec/template/spec/containers/0/image" ]
        target:
          kind: StatefulSet
          name: teleport-agent
          namespace: teleport
...

문제 해결#

다음을 실행하여 현재 자동 업데이트 상태를 확인할 수 있습니다:

$ tctl autoupdate agents status

Agent autoupdate mode: enabled
Rollout creation date: 2025-02-24 16:01:44
Start version: 17.2.0
Target version: 17.2.1
Rollout state: Unstarted
Strategy: time-based

Group Name State     Start Time State Reason
---------- --------- ---------- --------------
default    Unstarted            outside_window

이 롤아웃 상태는 각 Auth Service 인스턴스에 의해 1분마다 계산됩니다. autoupdate_config 또는 autoupdate_version 변경 사항이 반영되고 적용되는 데 최대 1분이 걸릴 수 있습니다.

Teleport 에이전트는 새 버전의 Teleport가 릴리즈될 때 즉시 업데이트되지 않으며, 에이전트 업데이트는 클러스터보다 며칠 뒤처질 수 있습니다.

Teleport 에이전트가 몇 주 동안 자동으로 업데이트되지 않은 경우 위에 설명된 업데이터 로그를 확인하여 문제를 해결할 수 있습니다.

teleport-update status 명령은 에이전트가 업데이트하도록 지시받는 방법을 결정하는 가장 좋은 UX를 제공합니다. 그러나 teleport-update를 사용할 수 없는 경우 curl을 사용하여 Teleport 클러스터에서 이 정보를 직접 쿼리할 수도 있습니다:

$ curl -s https://teleport.example.com/webapi/find | jq .auto_update
{
  ...
  "agent_version": "18.2.7",         # 에이전트가 업데이트해야 하는 버전 (새 에이전트에도 사용됨)
  "agent_auto_update": false,        # 창 내에 있고 에이전트가 지금 업데이트해야 하는 경우 true
  "agent_update_jitter_seconds": 60  # 클러스터 및 CDN 부하를 줄이기 위한 지터
}

group 및 update_id 매개변수를 사용하여 특정 에이전트에 맞게 조정할 수 있습니다:

$ curl -s https://teleport.example.com/webapi/find?group=staging&update_id=$(</tmp/teleport-update.id) | jq .auto_update
{
  ...
  "agent_version": "18.2.8",
  "agent_auto_update": true,
  "agent_update_jitter_seconds": 60
}

Kubernetes에서 관리형 에이전트 업그레이드 문제 해결#

업데이터는 주기적으로 예상되는 Kubernetes 리소스를 클러스터의 리소스와 조정하는 컨트롤러입니다. 업데이터는 30분마다 또는 Kubernetes 이벤트에 응답하여 조정 루프를 실행합니다. 다음 조정까지 기다리지 않으려면 이벤트를 트리거할 수 있습니다.

1. 배포 업데이트가 이벤트를 전송하므로 리소스에 주석을 달아 업그레이더를 트리거할 수 있습니다:

   $ kubectl -n  annotate statefulset/ 'debug.teleport.dev/trigger-event=1'
   

2. 에이전트의 관리형 업데이트를 일시 중단하려면 Helm의 annotations.deployment 값을 설정하거나 kubectl을 사용하여 배포를 직접 패치하여 에이전트 배포에 teleport.dev/skipreconcile: "true" 주석을 달 수 있습니다.

Linux에서 관리형 에이전트 업그레이드 문제 해결#

1. 다음을 실행하여 업데이터 상태를 쿼리할 수 있습니다:

   $ teleport-update status
   proxy: teleport.example.com:443
   path: /usr/local/bin
   base_url: https://cdn.teleport.dev
   enabled: true
   pinned: false
   active:
       version: 17.2.0
       flags: [Enterprise]
   target:
       version: 17.2.1
       flags: [Enterprise]
   in_window: false
   jitter: 1m0s
   

   여기서 로컬 활성 버전은 17.2.0입니다. 클러스터의 대상 버전은 17.2.1이지만 업데이트 창 내에 있지 않으므로 에이전트가 즉시 업데이트되지 않습니다.

2. 에이전트가 자동으로 업데이트되지 않는 경우 업데이터를 수동으로 호출하고 로그를 확인할 수 있습니다:

   $ sudo teleport-update update --now
   

다른 CDN URL 사용#

에이전트가 기본 Teleport CDN URL(cdn.teleport.dev)에 접근할 수 없는 경우 업데이트를 다운로드할 수 없습니다.

이 문제에 대한 몇 가지 잠재적 해결책이 있습니다:

HTTP CONNECT 프록시 사용#

teleport-update 프로세스의 환경에 HTTPS_PROXY 변수를 구성하면 이 프록시를 사용하여 업데이트를 가져옵니다.

기본 설치로 프록시를 구성하는 가장 쉬운 방법은 이 변수를 /etc/systemd/system/teleport-update.service.d/override.conf에 추가하는 것입니다:

$ sudo mkdir -p /etc/systemd/system/teleport-update.service.d
$ sudo tee -a /etc/systemd/system/teleport-update.service.d/override.conf > /dev/null <<'EOF'
[Service]
Environment=HTTPS_PROXY=http://proxy-url:3128
EOF

sudo journalctl -u teleport-update.service로 teleport-update 프로세스 로그를 볼 수 있습니다.

Teleport tarball 패키지 미러링 및 base-url 변경#

에이전트가 접근할 수 있는 위치에 Teleport tarball 설치 관리자를 미러링할 수 있는 경우, Teleport 업데이터에서 사용하는 base-url을 변경하여 직접 가져올 수 있습니다.

base-url을 변경하려면 teleport-update enable 명령에 -b 또는 --base-url 플래그를 추가해야 합니다:

$ sudo teleport-update enable --base-url https://teleport.artifactory.company.local

sudo teleport-update enable을 다시 실행하여 base URL을 수정하는 것이 안전합니다. 플래그에 의해 명시적으로 재정의되지 않으면 기존 업데이터 설정이 유지됩니다.

teleport-update enable과 함께 사용할 수 있는 플래그에 대한 자세한 정보는 여기에서 확인할 수 있습니다.

$ tsh login --proxy= --user=
$ tctl status
# Cluster  (=teleport.url=)
# Version  (=teleport.version=)
# CA pin   (=presets.ca_pin=)

$ sudo teleport-update enable

$ sudo apt remove teleport-ent-updater

$ sudo teleport-update uninstall

$ sudo teleport-update enable --overwrite

$ sudo systemctl disable machineid --now

$ sudo systemctl enable tbot --now

$ tar xf teleport-update-[version].tgz
$ cd teleport-update-[version]
$ sudo ./teleport-update enable --proxy example.teleport.sh

$ sudo systemctl enable teleport --now

$ sudo systemctl enable tbot --now

kind: autoupdate_config
metadata:
  name: autoupdate-config
spec:
  agents:
    mode: enabled
    strategy: halt-on-error
    schedules:
      regular:
        - name: default
          days: [ "Mon", "Tue", "Wed", "Thu" ]
          # start_hour은 UTC 기준
          start_hour: 16

kind: autoupdate_config
metadata:
  name: autoupdate-config
spec:
  agents:
    mode: enabled
    strategy: halt-on-error
    schedules:
      regular:
        - name: staging
          days: [ "Mon", "Tue", "Wed", "Thu" ]
          start_hour: 4
        - name: production
          days: [ "Mon", "Tue", "Wed", "Thu" ]
          start_hour: 5
          wait_hours: 24

kind: autoupdate_version
metadata:
  name: autoupdate-version
spec:
  agents:
    start_version: 17.2.0
    target_version: 17.2.1
    schedule: regular
    mode: enabled

$ tctl create -f autoupdate_version.yaml

$ tctl autoupdate agents status
Agent autoupdate mode: enabled
Rollout creation date: 2025-03-10 15:01:45
Start version: 1.2.3
Target version: 1.2.4
Rollout state: Active
Strategy: halt-on-error

Group Name State     Start Time          State Reason
---------- --------- ------------------- ------------------------
dev        Active    2025-03-11 12:00:10 can_start
stage      Unstarted                     previous_groups_not_done
prod       Unstarted                     previous_groups_not_done

Commands:
  autoupdate agents status       에이전트 자동 업데이트 상태를 출력합니다.
  autoupdate agents report       에이전트 자동 업데이트 보고서를 집계하고 버전별 및 업데이트 그룹별 에이전트 수를 표시합니다.
  autoupdate agents start-update 하나 이상의 그룹 업데이트를 시작합니다.
  autoupdate agents mark-done    하나 이상의 그룹을 업데이트 완료로 표시합니다.
  autoupdate agents rollback     하나 이상의 그룹을 롤백합니다.

$ tctl autoupdate agents start-update stage prod
Started updating agents groups: [stage prod].
New agent rollout status:

Group Name State     Start Time          State Reason
---------- --------- ------------------- --------------
dev        Unstarted                     cannot_start
stage      Active    2025-03-10 15:04:16 manual_trigger
prod       Active    2025-03-10 15:04:16 manual_trigger

$ tctl inventory ls --upgrader=none
Server ID                            Hostname      Services Version Upgrader
------------------------------------ ------------- -------- ------- --------
00000000-0000-0000-0000-000000000000 ip-10-1-6-130 Node     v14.4.5 none
...

$ tctl inventory ls --upgrader=unit
Server ID                            Hostname      Services Version Upgrader
------------------------------------ ------------- -------- ------- --------
00000000-0000-0000-0000-000000000000 ip-10-1-6-131 Node     v14.4.5 unit
...

$ sudo apt remove teleport-ent-updater

$ sudo yum remove teleport-ent-updater

$ sudo mkdir -p /etc/teleport-upgrade.d/
$ sudo touch /etc/teleport-upgrade.d/schedule
$ sudo chown your-teleport-user /etc/teleport-upgrade.d/schedule

Kubernetes 에이전트를 관리형 업데이트에 등록#

이 섹션은 teleport-kube-agent 릴리즈 이름이 teleport-agent이고 teleport 네임스페이스에 설치되어 있다고 가정합니다.

1. teleport-kube-agent 차트의 values 파일에 다음 차트 값을 추가합니다:

   updater:
     enabled: true
   

2. teleport-kube-agent 차트의 새 버전을 포함하도록 Teleport Helm 저장소를 업데이트합니다:

   $ helm repo update teleport
   

3. 새 값으로 Helm 차트 릴리즈를 업데이트합니다:

   Cloud-HostedSelf-Hosted

$ helm -n   upgrade  teleport/teleport-kube-agent \
--values=values.yaml \
--version="(=cloud.version=)"

$ helm -n   upgrade  teleport/teleport-kube-agent \
--values=values.yaml \
--version="(=teleport.version=)"

1. 업데이터의 파드가 준비 상태인지 확인하여 업데이터가 올바르게 실행되고 있는지 검증할 수 있습니다:

   $ kubectl -n teleport-agent get pods
   NAME                               READY   STATUS    RESTARTS   AGE
   <your-agent-release>-0                         1/1     Running   0          14m
   <your-agent-release>-1                         1/1     Running   0          14m
   <your-agent-release>-2                         1/1     Running   0          14m
   <your-agent-release>-updater-d9f97f5dd-v57g9   1/1     Running   0          16m
   

2. 업데이터 로그를 확인하여 배포 문제를 확인합니다:

   $ kubectl -n  logs deployment/-updater
   2023-04-28T13:13:30Z	INFO	StatefulSet is already up-to-date, not updating.	{"controller": "statefulset", "controllerGroup": "apps", "controllerKind": "StatefulSet", "StatefulSet": {"name":"my-agent","namespace":"agent"}, "namespace": "agent", "name": "my-agent", "reconcileID": "10419f20-a4c9-45d4-a16f-406866b7fc05", "namespacedname": "agent/my-agent", "kind": "StatefulSet", "err": "no new version (current: \"v12.2.3\", next: \"v12.2.3\")"}
   

GitOps 도구#

Kubernetes 에이전트의 관리형 업데이트는 지속적 배포를 위한 GitOps 도구와 함께 사용할 때 해결 방법이 필요합니다. teleport-kube-agent Helm 차트가 teleport-agent 리소스의 버전을 소유하므로 teleport-agent-updater가 teleport-agent 리소스의 이미지 버전을 수정하면 GitOps 도구가 teleport-agent 리소스에서 드리프트 또는 차이점을 감지합니다.

아래 섹션에서는 다양한 GitOps 도구에 대한 해결 방법을 설명합니다.

ArgoCD 배포#

관리형 업데이트 후 ArgoCD는 teleport-agent 리소스를 OutOfSync로 보고합니다. 이 문제를 해결하기 위해 Diff 사용자 정의를 사용하여 이미지 버전의 차이를 무시하세요. 다음은 이름 teleport-agent 및 네임스페이스 teleport를 사용하는 배포 예시입니다.

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: teleport-agent
  namespace: teleport
spec:
  ignoreDifferences:
    - group: apps
      kind: StatefulSet
      name: teleport-agent
      namespace: teleport
      jqPathExpressions:
        - .spec.template.spec.containers[] | select(.name == "teleport").image
...

FluxCD 배포#

관리형 업데이트 후 FluxCD는 DriftDetected 이벤트를 보고합니다. 이 문제를 해결하기 위해 드리프트 감지 구성을 수정하여 이미지 버전의 차이를 무시하세요. 다음은 이름 teleport-agent 및 네임스페이스 teleport를 사용하는 배포 예시입니다.

apiVersion: helm.toolkit.fluxcd.io/v2beta2
kind: HelmRelease
metadata:
  name: teleport-agent
  namespace: teleport
spec:
  driftDetection:
    mode: enabled
    ignore:
      - paths: [ "/spec/template/spec/containers/0/image" ]
        target:
          kind: StatefulSet
          name: teleport-agent
          namespace: teleport
...

문제 해결#

다음을 실행하여 현재 자동 업데이트 상태를 확인할 수 있습니다:

$ tctl autoupdate agents status

Agent autoupdate mode: enabled
Rollout creation date: 2025-02-24 16:01:44
Start version: 17.2.0
Target version: 17.2.1
Rollout state: Unstarted
Strategy: time-based

Group Name State     Start Time State Reason
---------- --------- ---------- --------------
default    Unstarted            outside_window

이 롤아웃 상태는 각 Auth Service 인스턴스에 의해 1분마다 계산됩니다. autoupdate_config 또는 autoupdate_version 변경 사항이 반영되고 적용되는 데 최대 1분이 걸릴 수 있습니다.

Teleport 에이전트는 새 버전의 Teleport가 릴리즈될 때 즉시 업데이트되지 않으며, 에이전트 업데이트는 클러스터보다 며칠 뒤처질 수 있습니다.

Teleport 에이전트가 몇 주 동안 자동으로 업데이트되지 않은 경우 위에 설명된 업데이터 로그를 확인하여 문제를 해결할 수 있습니다.

teleport-update status 명령은 에이전트가 업데이트하도록 지시받는 방법을 결정하는 가장 좋은 UX를 제공합니다. 그러나 teleport-update를 사용할 수 없는 경우 curl을 사용하여 Teleport 클러스터에서 이 정보를 직접 쿼리할 수도 있습니다:

$ curl -s https://teleport.example.com/webapi/find | jq .auto_update
{
  ...
  "agent_version": "18.2.7",         # 에이전트가 업데이트해야 하는 버전 (새 에이전트에도 사용됨)
  "agent_auto_update": false,        # 창 내에 있고 에이전트가 지금 업데이트해야 하는 경우 true
  "agent_update_jitter_seconds": 60  # 클러스터 및 CDN 부하를 줄이기 위한 지터
}

group 및 update_id 매개변수를 사용하여 특정 에이전트에 맞게 조정할 수 있습니다:

$ curl -s https://teleport.example.com/webapi/find?group=staging&update_id=$(</tmp/teleport-update.id) | jq .auto_update
{
  ...
  "agent_version": "18.2.8",
  "agent_auto_update": true,
  "agent_update_jitter_seconds": 60
}

Kubernetes에서 관리형 에이전트 업그레이드 문제 해결#

업데이터는 주기적으로 예상되는 Kubernetes 리소스를 클러스터의 리소스와 조정하는 컨트롤러입니다. 업데이터는 30분마다 또는 Kubernetes 이벤트에 응답하여 조정 루프를 실행합니다. 다음 조정까지 기다리지 않으려면 이벤트를 트리거할 수 있습니다.

1. 배포 업데이트가 이벤트를 전송하므로 리소스에 주석을 달아 업그레이더를 트리거할 수 있습니다:

   $ kubectl -n  annotate statefulset/ 'debug.teleport.dev/trigger-event=1'
   

2. 에이전트의 관리형 업데이트를 일시 중단하려면 Helm의 annotations.deployment 값을 설정하거나 kubectl을 사용하여 배포를 직접 패치하여 에이전트 배포에 teleport.dev/skipreconcile: "true" 주석을 달 수 있습니다.

Linux에서 관리형 에이전트 업그레이드 문제 해결#

1. 다음을 실행하여 업데이터 상태를 쿼리할 수 있습니다:

   $ teleport-update status
   proxy: teleport.example.com:443
   path: /usr/local/bin
   base_url: https://cdn.teleport.dev
   enabled: true
   pinned: false
   active:
       version: 17.2.0
       flags: [Enterprise]
   target:
       version: 17.2.1
       flags: [Enterprise]
   in_window: false
   jitter: 1m0s
   

   여기서 로컬 활성 버전은 17.2.0입니다. 클러스터의 대상 버전은 17.2.1이지만 업데이트 창 내에 있지 않으므로 에이전트가 즉시 업데이트되지 않습니다.

2. 에이전트가 자동으로 업데이트되지 않는 경우 업데이터를 수동으로 호출하고 로그를 확인할 수 있습니다:

   $ sudo teleport-update update --now
   

다른 CDN URL 사용#

에이전트가 기본 Teleport CDN URL(cdn.teleport.dev)에 접근할 수 없는 경우 업데이트를 다운로드할 수 없습니다.

이 문제에 대한 몇 가지 잠재적 해결책이 있습니다:

HTTP CONNECT 프록시 사용#

teleport-update 프로세스의 환경에 HTTPS_PROXY 변수를 구성하면 이 프록시를 사용하여 업데이트를 가져옵니다.

기본 설치로 프록시를 구성하는 가장 쉬운 방법은 이 변수를 /etc/systemd/system/teleport-update.service.d/override.conf에 추가하는 것입니다:

$ sudo mkdir -p /etc/systemd/system/teleport-update.service.d
$ sudo tee -a /etc/systemd/system/teleport-update.service.d/override.conf > /dev/null <<'EOF'
[Service]
Environment=HTTPS_PROXY=http://proxy-url:3128
EOF

sudo journalctl -u teleport-update.service로 teleport-update 프로세스 로그를 볼 수 있습니다.

Teleport tarball 패키지 미러링 및 base-url 변경#

에이전트가 접근할 수 있는 위치에 Teleport tarball 설치 관리자를 미러링할 수 있는 경우, Teleport 업데이터에서 사용하는 base-url을 변경하여 직접 가져올 수 있습니다.

base-url을 변경하려면 teleport-update enable 명령에 -b 또는 --base-url 플래그를 추가해야 합니다:

$ sudo teleport-update enable --base-url https://teleport.artifactory.company.local

sudo teleport-update enable을 다시 실행하여 base URL을 수정하는 것이 안전합니다. 플래그에 의해 명시적으로 재정의되지 않으면 기존 업데이터 설정이 유지됩니다.

teleport-update enable과 함께 사용할 수 있는 플래그에 대한 자세한 정보는 여기에서 확인할 수 있습니다.