Tilt를 사용한 클러스터 API 개발 편집하기

== 개요 ==
;Developing Cluster API with Tilt
;Tilt를 사용한 클러스터 API 개발

이 문서에서는 간편한 배포와 빠른 반복 빌드를 제공하는 단순화된 워크플로우를 위해 [[kind]]와 [[Tilt]]를 사용하는 방법을 설명합니다 .

== 전제조건 ==
# [[Docker]]: v19.03 이상
# [[kind]]: v0.22.0 이상
# [[Tilt]]: v0.30.8 이상
# [[kustomize]]: <code>make kustomize</code>를 통해 제공
# [[envsubst]]: <code>make envsubst</code>를 통해 제공
# [[helm]]: v3.7.1 이상
# [https://github.com/kubernetes-sigs/cluster-api Cluster API] 저장소를 로컬로 클론
# 로컬로 배포하려는 제공자도 클론

== 시작하기 ==
=== kind 클러스터 생성 ===
로컬 Docker 레지스트리와 함께 KIND 클러스터를 생성하는 스크립트 및 CAPD를 실행하기 위한 올바른 마운트가 hack/ 폴더에 포함되어 있습니다.

사전설정된 클러스터를 생성하려면 다음을 실행하세요:
<syntaxhighlight lang='bash'>
./hack/kind-install-for-capd.sh
</syntaxhighlight>

다음을 사용하여 클러스터의 상태를 확인할 수 있습니다:
<syntaxhighlight lang='bash'>
kubectl cluster-info --context kind-capi-test
</syntaxhighlight>

=== tilt-settings 파일 생성 ===
다음으로, <code>tilt-settings.yaml</code> 파일을 생성하고 이를 <code>cluster-api</code>의 로컬 복사본에 붙입니다. 다음은 CAPI 리포지토리의 컴포넌트를 사용하는 예시입니다.

<syntaxhighlight lang='yaml'>
default_registry: gcr.io/your-project-name-here
enable_providers:
- docker
- kubeadm-bootstrap
- kubeadm-control-plane
</syntaxhighlight>

To use tilt to launch a provider with its own repo, using Cluster API Provider AWS here, tilt-settings.yaml should look like:
tilt를 사용하여 자체 리포지토리가 있는 제공자를 시작하려면, 여기서는 Cluster API Provider AWS를 사용하며, <code>tilt-settings.yaml</code>는 다음과 같은 형식이어야 합니다.

<syntaxhighlight lang='yaml'>
default_registry: gcr.io/your-project-name-here
provider_repos:
- ../cluster-api-provider-aws
enable_providers:
- aws
- kubeadm-bootstrap
- kubeadm-control-plane
</syntaxhighlight>

JSON을 선호한다면, 대신 <code>tilt-settings.json</code> 파일을 생성할 수 있습니다. 두 파일이 다 있는 경우 YAML이 선호됩니다.

==== tilt-settings 필드 ====
;디버거 연결
;Visual Studio
위의 예제를 사용할 때, 다음 시작 설정을 사용하여 Visual Studio Code에서 core CAPI controller를 디버깅할 수 있습니다.

<syntaxhighlight lang='json'>
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Core CAPI Controller",
      "type": "go",
      "request": "attach",
      "mode": "remote",
      "remotePath": "",
      "port": 30000,
      "host": "127.0.0.1",
      "showLog": true,
      "trace": "log",
      "logOutput": "rpc"
    }
  ]
}
</syntaxhighlight>

;Goland / IntelliJ
위의 예시를 활용하면 포트 30000을 가리키는 [https://www.jetbrains.com/help/go/attach-to-running-go-processes-with-debugger.html#step-3-create-the-remote-run-debug-configuration-on-the-client-computer Go Remote 실행/디버그 설정]을 설정할 수 있습니다.

=== kind 클러스터 생성하고 Tilt 실행! ===
사전설정된 kind 클러스터를 생성하고(아직 수행하지 않은 경우) 개발 환경을 시작하려면 다음을 실행합니다.

<syntaxhighlight lang='bash'>
make tilt-up
</syntaxhighlight>

그러면 명령줄 HUD와 웹 브라우저 인터페이스가 열립니다. 어느 위치에서나 Tilt의 상태를 모니터링할 수 있습니다. 잠시 후에 개발환경이 실행되고 이제 클러스터를 생성할 수 있습니다. 사용가능한 [https://github.com/kubernetes-sigs/cluster-api/tree/main/test/infrastructure/docker/examples 워커 클러스터 설정 예시]가 있습니다. 이는 특정 요구에 맞게 커스터마이징할 수 있습니다.

=== 워크로드 클러스터 배포 ===
kind 관리 클러스터가 Tilt로 실행되고 나면, [[#tilt-settings 필드|tilt-settings.yaml]] 파일(기본값 <code>./test/infrastructure/docker/templates</code>)의 <code>template_dirs</code> 필드에 지정된 디렉토리의 YAML 템플릿을 기반으로 Tilt 웹 UI에 워크로드 클러스터를 배포할 수 있습니다.

템플릿 이름은 clusterctl 컨벤션에 따라 지정되어야 합니다:
* 템플릿 파일의 이름은 <code>cluster-template-{name}.yaml</code>로 지정되어야 합니다. 해당 파일은 레이블 그룹 <code>{provider-label}.templates</code> (예: <code>CAPD.templates</code>) 아래의 Tilt 웹UI에서 액세스할 수 있습니다.
* 클러스터 클래스 파일의 이름은 <code>clusterclass-{name}.yaml</code>로 지정되어야 합니다. 해당 파일은 레이블 그룹 <code>{provider-label}.clusterclasses</code> (예: <code>CAPD.clusterclasses</code>) 아래의 Tilt 웹UI에서 액세스할 수 있습니다.

Tilt 웹UI 버튼 세트에서 해당 항목 중 하나를 선택하면, 변수 대체를 커스터마이징하기 위한 드롭다운을 사용하여 클러스터를 생성하거나, 클러스터를 삭제할 수 있습니다. 변수 대체에 대한 커스텀 값은 <code>tilt-settings.yaml</code>의 <code>kustomize_substitutions</code>를 사용하여 설정할 수 있습니다. 예시:

<syntaxhighlight lang='yaml'>
kustomize_substitutions:
  NAMESPACE: "default"
  KUBERNETES_VERSION: "v1.29.2"
  CONTROL_PLANE_MACHINE_COUNT: "1"
  WORKER_MACHINE_COUNT: "3"
# 참고: kustomize 대체에서는 값이 문자열일 것으로 기대합니다. 값을 따옴표로 묶으면 문자열이 됩니다.
</syntaxhighlight>

=== kind 클러스터와 개발환경 정리 ===
Tilt를 중지한 후, 다음을 실행하여 kind 클러스터 및 개발환경을 정리할 수 있습니다.

<syntaxhighlight lang='bash'>
make clean-kind
</syntaxhighlight>

자동생성된 모든 파일을 제거하려면, 다음을 실행하세요.

<syntaxhighlight lang='bash'>
make clean
</syntaxhighlight>

<code>tilt-settings.yaml</code>에서 <code>deploy_observability</code>을 사용하여 배포된 차트의 새 버전을 가져오려면, <code>make clean</code> 또는 <code>make clean-charts</code>를 실행해야 합니다.

== clusterctl 사용 ==
tilt로 워커 클러스터를 생성한 경우, <code>clusterctl</code>을 관리 작업에 사용해서는 안됩니다. 이는 tilt는 clusterctl init처럼 관리 클러스터에서 제공자를 초기화하지 않기 때문에, clusterctl config와 같은 일부 clusterctl 명령어가 작동하지 않기 때문입니다.

이러한 한계점은 컨트롤러 로직에 대한 빠른 개발-테스트 반복을 실행하는 동안 수용가능한 절충안입니다. 대신 clusterctl 테스트 워크플로우에 관심이 있다면, [[cluster-api/개발자를 위한 clusterctl|clusterctl 개발자 지침]]을 참조해야 합니다.

== 사용가능 제공자 ==
현재 Tiltfile에 정의된 제공자는 다음과 같습니다:

* core: cluster-api 자체
* kubeadm-bootstrap: kubeadm 부트스트랩 제공자
* kubeadm-control-plane: kubeadm 컨트롤플레인 제공자
* docker: Docker 인프라스트럭처 제공자
* in-memory: In-memory 인프라스트럭처 제공자
* test-extension: CAPI E2E 테스트에서 사용하는 런타임 확장기능

다음 문단에 설명된 절차에 따라 제공자를 추가할 수 있습니다.

=== tilt-provider 설정 ===
제공자는 빌드 방법을 설명하는 <code>tilt-provider.yaml</code> 파일을 제공해야 합니다. 예시는 다음과 같습니다.

<syntaxhighlight lang='yaml'>
name: aws
config:
  image: "gcr.io/k8s-staging-cluster-api-aws/cluster-api-aws-controller"
  live_reload_deps: ["main.go", "go.mod", "go.sum", "api", "cmd", "controllers", "pkg"]
  label: CAPA
</syntaxhighlight>

JSON을 선호한다면, 대신 <code>tilt-provider.json</code> 파일을 생성할 수 있습니다. 두 파일이 다 있는 경우 YAML이 선호됩니다.

==== 설정 필드 ====
'''image''': kustomize 파일에서 참조되는 이 제공자의 이미지. 이는 매치되어야 하며, 안되면 Tilt는 빌드를 하지 않습니다.

'''live_reload_deps''': 감시할 파일/디렉토리 목록. 하나라도 변경되면, Tilt는 제공자에 대한 매니저 바이너리를 재빌드하고 구동 중인 컨테이너의 실시간 업데이트를 수행합니다.

'''version''': 제공자 CR에 사용할 버전을 정의할 수 있습니다. 비어 있으면 기본 버전이 사용됩니다.

'''additional_docker_helper_commands''' (String, default=””): 헬퍼 이미지 docker 빌드에서 실행할 추가 명령어. 예시:

<syntaxhighlight lang='bash'>
RUN wget -qO- https://dl.k8s.io/v1.21.2/kubernetes-client-linux-amd64.tar.gz | tar xvz
RUN wget -qO- https://get.docker.com | sh
</syntaxhighlight>

'''additional_docker_build_commands''' (String, default=””): dockerfile에 추가할 추가 명령어. 매니저 이미지는 docker-slim을 사용하므로 파일을 다운로드하려면, <code>additional_helper_image_commands</code>를 사용하십시오. 예시:

<syntaxhighlight lang='bash'>
COPY --from=tilt-helper /usr/bin/docker /usr/bin/docker
COPY --from=tilt-helper /go/kubernetes/client/bin/kubectl /usr/bin/kubectl
</syntaxhighlight>

'''kustomize_folder''' (String, default=config/default): 제공자의 kustomize 파일이 정의된 폴더. 경로는 제공자 루트 폴더에 대해 상대적입니다.

'''kustomize_options''' ([]String, default=[]): 제공자에 대한 yaml 매니페스트를 생성하기 위해 kustomize를 실행할 때 적용할 옵션. 예시: <code>"kustomize_options": [ "--load-restrictor=LoadRestrictionsNone" ]</code>

'''apply_provider_yaml''' (Bool, default=true): 제공자 yaml을 적용할지 여부. 제공자에 ./config 폴더가 없거나 클러스터에 적용하지 않으려면 false로 설정하십시오.

'''go_main''' (String, default=”main.go”): go main 파일이 폴더의 루트에 있지 않은 경우

'''label''' (String, default=provider name): 버전 v0.22.2 이상, 틸트 UI에서 제공자 컴포넌트를 그룹화하는 데 사용되는 레이블(https://blog.tilt.dev/2021/08/09/resource-grouping.html 참조); 관례적으로 제공자 약어를 사용해야 합니다(CAPD, KCP 등).

'''additional_resources''' ([]string, default=[]): tilt 클러스터에 로드될 yaml 파일의 경로 목록. 예를 들어 RuntimeExtension 제공자에 대한 ExtensionConfig 객체를 배포하기 위해 이를 사용합니다.

'''resource_deps''' ([]string, default=[]): 
현재 제공자 전에 설치될 tilt 리소스 이름 목록. 예를 들어 이 제공자가 클러스터 API 이후에 설치되도록 하려면, 이를 [“capi_controller”]로 지정합니다.

== Tilt 커스터마이징 ==
Tilt의 동작을 커스터마이징해야 하는 경우, cluster-api의 tilt.d 디렉토리에 파일을 만들 수 있습니다. 이 파일은 git에서 무시되므로 여기에 배치한 모든 파일은 소스 제어에 체크인되지 않습니다.

이러한 파일은 제공자 맵이 정의된 후와 모든 헬퍼 함수 정의 뒤에 포함됩니다. 이는 "실제 작업"이 일어나기 직전입니다.

== 수면 아래에서, “실제 작업” ==
높은 수준에서 Tiltfile은 다음 작업을 수행합니다.

# <code>tilt-settings.yaml</code> 읽기
# 허용되는 Kubernetes 컨텍스트 설정
# 기본 레지스트리 설정
# <code>provideres</code> 맵 정의
# 사용자 정의 Tilt 파일 인클루드
# cert-manager 배포
# 제공자 활성화(<code>core</code> + <code>tilt-settings.yaml</code>에 나열된 것)
## 로컬에서 <code>local_resource</code>로 매니저 바이너리 빌드
## 제공자에 대해 <code>docker_build</code> 호출
## 제공자의 <code>config/</code> 디렉토리에 대해 <code>kustomize</code> 호출

===라이브 업데이트===
제공자 맵의 각 제공자에는 <code>live_reload_deps</code> 목록이 있습니다. 이는 Tilt가 변경사항을 모니터링해야 하는 파일 및/또는 디렉토리를 정의합니다. 의존성이 수정되면, Tilt는 '''로컬 머신에서''' 제공자 매니저 바이너리를 재빌드하고, 바이너리를 구동 중인 컨테이너에 복사한 다음, 재시작 스크립트를 실행합니다. 이는 각 변경사항에 대해 컨테이너 이미지를 다시 빌드하는 것보다 훨씬 빠릅니다. 또한 각 개발 이미지의 크기를 가능한 한 작게 유지하는 데 도움이 됩니다(컨테이너 이미지에는 전체 Go 도구 체인, 소스 코드, 모듈 의존성 등이 필요하지 않음).

== Tiltfile IDE 지원==
IntelliJ의 경우, Tiltfile의 구문 강조 표시를 TextMate 번들로 설정할 수 있습니다. 지침은 [https://github.com/tilt-dev/tiltfile.tmbundle Tiltfile TextMate Bundle]을 참조하세요.

VSCode의 경우, [https://marketplace.visualstudio.com/items?itemName=BazelBuild.vscode-bazel Bazel 플러그인]을 사용할 수 있으며, 구문 강조 및 자동 포맷팅을 제공합니다. Tiltfile에 대해 이를 활성화하려면 사용자 세팅을 통해 파일 연계를 설정해야 합니다:

<syntaxhighlight lang='json'>
"files.associations": {
  "Tiltfile": "starlark",
},
</syntaxhighlight>

== Podman 사용 ==
다음 작업을 수행하면 Docker 대신 Podman을 사용할 수 있습니다:

# podman 유닉스 소켓을 활성화합니다:
#* 리눅스/systemd에서: <code>systemctl --user enable --now podman.socket</code>
#* 맥OS에서: <code>podman machine init</code>으로 podman 머신 생성
# <code>tilt-settings.yaml</code>에서 <code>build_engine</code>를 podman으로 지정 (선택사항, Docker와 podman이 모두 설치된 경우에만)
# 환경변수 DOCKER_HOST를 올바른 소켓으로 정의합니다.
#* 리눅스/systemd에서: <code>export DOCKER_HOST=unix:///run/user/$(id -u)/podman/podman.sock</code>
#* 맥OS에서: <code>export DOCKER_HOST=$(podman machine inspect <machine> | jq -r '.[0].ConnectionInfo.PodmanSocket.Path')</code> 여기서 <code><machine></code>은 podman 머신 이름
# <code>tilt up</code> 실행

참고: <code>DOCKER_HOST</code>에 의해 정의된 소켓은 <code>hack/tools/internal/tilt-prepare</code> 명령어에만 사용되며, 이미지 빌드는 <code>podman build</code> / <code>podman push</code> 명령어를 실행합니다.

== Tilt 트러블슈팅 ==
=== Tilt 스턱 ===
연결을 기다리는 동안 tilt가 멈춘 것처럼 보일 때가 있습니다.

docker/podman이 구동 중이고 kubernetes 클러스터에 연결할 수 있는지 확인하세요.

=== tilt-prepare 구동 오류 ===
==== failed to get current context from the KubeConfig file ====
* <code>kubectl cluster-info</code>를 실행하여 기본 컨텍스트의 클러스터에 연결할 수 있는지 확인하세요.
* <code>kubectl config use-context</code>를 사용하여 올바른 컨텍스트로 전환하세요.
* 컨텍스트가 허용되는지 확인하세요. [[#tilt-settings 필드|'''allowed_contexts''' 필드]]를 참조하세요.

==== Cannot connect to the Docker daemon ====
* docker 데몬이 실행 중인지 확인하세요 ;) 또는 podman의 경우 [[#Podman 사용|Podman 사용]]을 참조하세요.
* DOCKER_HOST가 지정된 경우:
** DOCKER_HOST에 올바른 접두어(보통 <code>unix://</code>)가 있는지 확인하세요.
** <code>fuser</code> / <code>lsof</code> / <code>netstat -u</code>를 사용하여 docker/podman이 $DOCKER_HOST를 리슨하고 있는지 확인하세요.

=== 레지스트리 pull/push 오류 ===
==== connection refused / denied / not found ====
[[#tilt-settings 필드|'''default_registry''' 필드]]가 이미지를 가져오고 푸시할 수 있는 유효한 레지스트리인지 확인하십시오 .

==== server gave HTTP response to HTTPS client ====
기본적으로 localhost:5000을 제외한 모든 레지스트리는 HTTPS를 통해 액세스됩니다.

HTTP 레지스트리를 실행하는 경우 docker/podman에서 레지스트리를 설정해야 할 수도 있습니다.

예를 들어, podman에서는 <code>localhost:5001</code> 레지스트리 설정을 다음 내용으로 <code>/etc/containers/registries.conf.d</code> 내에 선언해야 합니다.

<syntaxhighlight lang='aconf'>
[[registry]]
location = "localhost:5001"
insecure = true
</syntaxhighlight>

주의: macOS에서는 이 설정을, <code>podman machine ssh <machine></code>를 실행하여, '''podman 머신 내에서''' 수행해야 합니다.

=== kind 이미지 로딩 오류 ===
다음을 실행하여 kind에 이미지를 수동으로 로드할 수 있습니다.

<syntaxhighlight lang='bash'>
kind load docker-image --name=<kind_cluster> <image>
</syntaxhighlight>

==== image: "..." not present locally ====
Podman을 구동 중인 경우, 다음 버그가 있을 수 있습니다: https://github.com/kubernetes-sigs/kind/issues/2760

워크어라운드는 <code>podman</code> 실행파일에 대한 <code>docker</code> 심링크를 만들고 이미지를 다시 로드하는 것입니다.

==참고==
* https://cluster-api.sigs.k8s.io/developer/tilt 

[[분류: cluster-api]]
@@ 12번째 줄: / 12번째 줄: @@
 # [[envsubst]]: <code>make envsubst</code>를 통해 제공
 # [[helm]]: v3.7.1 이상
-# [https://github.com/kubernetes-sigs/cluster-api Cluster API] 리포지토리를 로컬로 클론
+# [https://github.com/kubernetes-sigs/cluster-api Cluster API] 저장소를 로컬로 클론
 # 로컬로 배포하려는 제공자도 클론
@@ 40번째 줄: / 40번째 줄: @@
 </syntaxhighlight>
+To use tilt to launch a provider with its own repo, using Cluster API Provider AWS here, tilt-settings.yaml should look like:
 tilt를 사용하여 자체 리포지토리가 있는 제공자를 시작하려면, 여기서는 Cluster API Provider AWS를 사용하며, <code>tilt-settings.yaml</code>는 다음과 같은 형식이어야 합니다.
@@ 55번째 줄: / 56번째 줄: @@
 ==== tilt-settings 필드 ====
-'''allowed_contexts''' (Array, default=[]): Tilt가 사용할 수 있는 kubeconfig 컨텍스트 목록. 자세한 내용은 [https://docs.tilt.dev/api.html#api.allow_k8s_contexts allow_k8s_contexts]에 있는 Tilt 문서를 참조하세요.
-'''default_registry''' (String, default=[]): 이미지를 push해야 하는 경우 사용할 이미지 레지스트리. 자세한 내용은 [https://docs.tilt.dev/api.html#api.default_registry Tilt 문서]를 참조하세요. 로컬 레지스트리를 사용하지 않는 경우, 이 값이 필요합니다. 또한 Cluster API Tiltfile은 실수로 <code>gcr.io/k8s-staging-cluster-api</code>에 push되는 것을 방지합니다.
-'''build_engine''' (String, default=”docker”): 이미지를 빌드하는 데 사용되는 엔진. <code>docker</code> 또는 <code>podman</code>일 수 있습니다. 참고: 기본값은 동적이며 <code>docker version</code>(명령어가 실패한 경우 <code>podman version</code>)에 문자열 "Podman Engine"이 있는 경우  "podman"이 됩니다.
-'''kind_cluster_name''' (String, default=”capi-test”): 이미지를 미리 로드할 때 사용할 kind 클러스터의 이름
-'''provider_repos''' (Array[]String, default=[]): 사용하려는 모든 제공자에 대한 경로 목록. 각 제공자에는 제공자 빌드 방법을 설명하는 <code>tilt-provider.yaml</code> 또는 <code>tilt-provider.json</code> 파일이 있어야 합니다.
-'''enable_providers''' (Array[]String, default=[‘docker’]): 활성화할 제공자 목록. 자세한 내용은 [[#사용가능 제공자|사용가능 제공자]]를 참조하세요 .
-'''template_dirs''' (Map{String: Array[]String}, default={”docker”: [ “./test/infrastructure/docker/templates”]}): 클러스터 템플릿이 포함된 디렉토리에 대한 제공자 맵. 아래에 필드의 예시가 있습니다. 어떻게 사용되는지는 [[#워크로드 클러스터 배포|워크로드 클러스터 배포]]를 참조하세요 .
-<syntaxhighlight lang='yaml'>
-template_dirs:
-  docker:
-  - ./test/infrastructure/docker/templates
-  - <other-template-dir>
-  azure:
-  - <azure-template-dir>
-  aws:
-  - <aws-template-dir>
-  gcp:
-  - <gcp-template-dir>
-</syntaxhighlight>
-'''kustomize_substitutions''' (Map{String: String}, default={}): 제공자 yaml에 있는 ${}-스타일 자리표시자에 대한 선택적 대체 맵. 이러한 대체항목은 클러스터 템플릿을 배포할 때도 사용됩니다. [[#워크로드 클러스터 배포|워크로드 클러스터 배포]]를 참조하세요 .
-참고 : Tilt로 관리되는 기존 클러스터를 사용하여 로컬로 E2E 테스트를 실행할 때, 성공적인 테스트를 위해서는 다음 대체항목이 필요합니다.
-<syntaxhighlight lang='yaml'>
-kustomize_substitutions:
-  CLUSTER_TOPOLOGY: "true"
-  EXP_KUBEADM_BOOTSTRAP_FORMAT_IGNITION: "true"
-  EXP_RUNTIME_SDK: "true"
-  EXP_MACHINE_SET_PREFLIGHT_CHECKS: "true"
-</syntaxhighlight>
-AWS
-예를 들어 yaml에 <code>${AWS_B64ENCODED_CREDENTIALS}</code>가 포함된 경우, 다음을 수행할 수 있습니다.
-<syntaxhighlight lang='yaml'>
-kustomize_substitutions:
-  AWS_B64ENCODED_CREDENTIALS: "your credentials here"
-</syntaxhighlight>
-'''deploy_observability''' ([string], default=[]): 세팅된 경우, 관찰가능성 도구 중 하나를 개발 클러스터에 설치합니다. 중요! 이 기능을 사용하려면 사용자 경로에서 helm 명령어를 사용할 수 있어야 합니다.
-지원되는 값은 다음과 같습니다:
-* <code>grafana</code>*: 대시보드를 만들고 <code>loki</code>, <code>prometheus</code>, <code>tempo</code> 쿼리하기 위한 것
-* <code>kube-state-metrics</code>: Kubernetes와 CAPI 리소스에 대한 메트릭을 <code>prometheus</code>에 노출하기 위한 것
-* <code>loki</code>: 로그를 수신하고 저장하기 위한 것
-* <code>metrics-server</code>: <code>kubectl top node/pod</code> 활성화하기 위한 것
-* <code>prometheus</code>*: Kubernetes에서 메트릭을 수집하기 위한 것
-* <code>promtail</code>: 파드 로그를 <code>loki</code>에 제공하기 위한 것
-* <code>parca</code>*: 프로파일링 데이터를 시각화하기 위한 것
-* <code>tempo</code>: 트레이스를 저장하기 위한 것
-* <code>visualizer</code>*: 각 클러스터의 Cluster API 리소스를 시각화하고, 모든 리소스의 사양 및 상태에 대한 빠른 액세스를 제공하기 위한 것
-<nowiki>*:</nowiki> 참고: UI는 tilt 콘솔의 링크를 통해 액세스할 수 있습니다.
-'''additional_kustomizations''' (map[string]string, default={}): 세팅된 경우 kustomize를 사용하여 빌드된 추가 리소스를 클러스터에 설치합니다. 예시:
-<syntaxhighlight lang='yaml'>
-additional_kustomizations:
-  capv-metrics: ../cluster-api-provider-vsphere/config/metrics
-</syntaxhighlight>
-'''debug''' (Map{string: Map} default{}): 제공자의 지명 설정 맵. key는 제공자 이름입니다.
-지원하는 세팅:
-* '''port''' (int, default=0 (disabled)): 0이 아닌 값으로 세팅되면, Tilt는 delve를 사용하여 제공자를 실행하고 localhost의 지정된 디버그 포트로 delve 서버를 포트 전달합니다. 그런 다음 Visual Studio Code, Goland, IntelliJ와 같은 IDE와 함께 사용할 수 있습니다.
-* '''continue''' (bool, default=true): 기본적으로, Tilt는 <code>--continue</code>를 사용하여 delve를 실행하므로, 특별히 중단점을 입력하지 않는 한 디버깅이 켜져 있는 모든 제공자는 정상적으로 실행됩니다. 기본적으로 컨트롤러가 시작되지 않도록 하려면 false로 변경하세요.
-* '''profiler_port''' (int, default=0 (disabled)): 0이 아닌 값으로 세팅되면, Tilt는 <code>--profiler-address</code>를 가지고 프로파일러를 활성화하고 포트 포워드를 셋업합니다. 컨트롤러의 Tilt 웹 UI에 "프로파일러(profiler)" 링크가 표시됩니다.
-* '''metrics_port''' (int, default=0 (disabled)): 0이 아닌 값으로 세팅되면, Tilt는 기본 메트릭 포트로 포트 포워드합니다. 컨트롤러의 Tilt 웹 UI에 "메트릭(metrics)" 링크가 표시됩니다.
-* '''race_detector''' (bool, default=false) (Linux amd64 only): 활성화되면, Tilt는 지정된 컨트롤러를 cgo로 컴파일하고 시스템 glibc에서 정적으로 컴파일하며 레이스 감지기를 활성화합니다. 현재, 이것은 Linux amd64 시스템에서 빌드할 때만 지원됩니다. 이것이 작동하려면 glibc-static을 설치하거나 libc.a를 사용할 수 있어야 합니다.
-예시: 아래 설정 사용:
-<syntaxhighlight lang='yaml'>
-  debug:
-    core:
-      continue: false
-      port: 30000
-      profiler_port: 40000
-      metrics_port: 40001
-</syntaxhighlight>
 ;디버거 연결
 ;Visual Studio
@@ 175번째 줄: / 82번째 줄: @@
 ;Goland / IntelliJ
 위의 예시를 활용하면 포트 30000을 가리키는 [https://www.jetbrains.com/help/go/attach-to-running-go-processes-with-debugger.html#step-3-create-the-remote-run-debug-configuration-on-the-client-computer Go Remote 실행/디버그 설정]을 설정할 수 있습니다.
-'''deploy_cert_manager''' (Boolean, default=<code>true</code>): 웹훅 등록에 사용하기 위해 cert-manager를 클러스터에 배포합니다.
-'''trigger_mode''' (String, default=<code>auto</code>): 변경에 따라 tilt를 자동으로 재빌드할지 여부를 설정하는 옵션 세팅. 자동 재빌드를 비활성화하고 사용자가 UI를 통해 변경된 개별 컴포넌트의 재빌드를 트리거하도록 하려면 수동으로 설정합니다.
-'''extra_args''' (Object, default=<code>{}</code>): 이 제공자에 대해 설정된 메인 바이너리에 전달할 추가 인수에 대한 제공자 매핑. 배열의 각 항목은 지정된 제공자의 매니저에 전달됩니다.
-예시:
-<syntaxhighlight lang='yaml'>
-extra_args:
-  kubeadm-bootstrap:
-  - --logging-format=json
-</syntaxhighlight>
-이 설정을 사용하면, 각 매니저가 다음과 같이 호출됩니다.
-<syntaxhighlight lang='bash'>
-manager --logging-format=json
-</syntaxhighlight>
 === kind 클러스터 생성하고 Tilt 실행! ===
@@ 240번째 줄: / 128번째 줄: @@
 tilt로 워커 클러스터를 생성한 경우, <code>clusterctl</code>을 관리 작업에 사용해서는 안됩니다. 이는 tilt는 clusterctl init처럼 관리 클러스터에서 제공자를 초기화하지 않기 때문에, clusterctl config와 같은 일부 clusterctl 명령어가 작동하지 않기 때문입니다.
-이러한 한계점은 컨트롤러 로직에 대한 빠른 개발-테스트 반복을 실행하는 동안 수용가능한 절충안입니다. 대신 clusterctl 테스트 워크플로우에 관심이 있다면, [[개발자를 위한 clusterctl|clusterctl 개발자 지침]]을 참조해야 합니다.
+이러한 한계점은 컨트롤러 로직에 대한 빠른 개발-테스트 반복을 실행하는 동안 수용가능한 절충안입니다. 대신 clusterctl 테스트 워크플로우에 관심이 있다면, [[cluster-api/개발자를 위한 clusterctl|clusterctl 개발자 지침]]을 참조해야 합니다.
 == 사용가능 제공자 ==
 현재 Tiltfile에 정의된 제공자는 다음과 같습니다:
-* '''core''': cluster-api 자체
+* core: cluster-api 자체
-* '''kubeadm-bootstrap''': kubeadm 부트스트랩 제공자
+* kubeadm-bootstrap: kubeadm 부트스트랩 제공자
-* '''kubeadm-control-plane''': kubeadm 컨트롤플레인 제공자
+* kubeadm-control-plane: kubeadm 컨트롤플레인 제공자
-* '''docker''': Docker 인프라스트럭처 제공자
+* docker: Docker 인프라스트럭처 제공자
-* '''in-memory''': In-memory 인프라스트럭처 제공자
+* in-memory: In-memory 인프라스트럭처 제공자
-* '''test-extension''': CAPI E2E 테스트에서 사용하는 런타임 확장기능
+* test-extension: CAPI E2E 테스트에서 사용하는 런타임 확장기능
 다음 문단에 설명된 절차에 따라 제공자를 추가할 수 있습니다.