Bridge to Kubernetes 구성

참고 항목

Microsoft는 더 이상 Bridge to Kubernetes 프로젝트를 적극적으로 유지 관리하지 않을 계획입니다. 앞으로 몇 개월 동안 프로젝트를 보관 상태로 전환할 것입니다. 그 동안 프로젝트를 계속 사용하고 다운로드할 수 있습니다. 이 기간 동안 나중에 사용할 수 있도록 Bridge to Kubernetes와 유사한 혜택을 제공하는 커뮤니티 프로젝트를 탐색하고 추천할 수 있기를 바랍니다. 질문이 있는 경우 GitHub의 문제 보드에서 문의하세요.

두 가지 방법을 사용하여 로컬 Bridge to Kubernetes 프로세스를 구성할 수 있습니다. 클러스터에서 서비스에 주석을 달 수 있으며 로컬 구성을 제공할 수 있습니다.

Kubernetes 구성

Kubernetes 구성(kubeconfig) 파일은 기본적으로 ~/.kube/config에 저장되지만 KUBECONFIG 환경 변수를 사용하여 설정할 수 있습니다.

Visual Studio를 사용하는 경우 디버그 속성의 디버그 시작 프로필 UI를 사용하여 IDE에서 Bridge to Kubernetes 시작 프로필을 편집할 수 있습니다. 시작 프로필 편집을 참조하세요.

여기에서 가장 일반적인 구성 속성 중 일부를 편집하는 방법을 제공하는 다음 화면을 열 수 있습니다.

Bridge to Kubernetes가 특정 포트를 전달하지 못하도록 방지

서비스에 주석을 추가하여 bridgetokubernetes/ignore-ports Kubernetes 서비스의 특정 포트를 컴퓨터에 매핑하지 않도록 Bridge to Kubernetes를 구성합니다.

apiVersion: v1
kind: Service
metadata:
  annotations:
    bridgetokubernetes/ignore-ports:445,23

로컬 구성 사용(KubernetesLocalProcessConfig.yaml)

KubernetesLocalProcessConfig.yaml 파일을 사용하면 클러스터의 Pod에 사용할 수 있는 환경 변수 및 탑재된 파일을 복제할 수 있습니다. KubernetesLocalProcessConfig.yaml 파일에서 다음 작업을 지정할 수 있습니다.

• 볼륨을 다운로드하고 해당 볼륨의 경로를 환경 변수로 설정합니다.
• 클러스터에서 실행되는 서비스를 개발용 컴퓨터에서 실행 중인 프로세스에서 사용할 수 있도록 합니다.
• 상수 값을 사용하여 환경 변수를 만듭니다.

기본 KubernetesLocalProcessConfig.yaml 파일은 자동으로 생성되지 않으므로 프로젝트의 루트에서 수동으로 파일을 만들어야 합니다.

볼륨 다운로드

env에서 다운로드하려는 각 볼륨에 대해 name 및 value를 지정합니다. name은 개발용 컴퓨터에서 사용할 환경 변수입니다. value는 볼륨의 이름과 개발용 컴퓨터의 경로입니다. value 값은 $(volumeMounts:VOLUME_NAME)/PATH/TO/FILES 형식입니다.

예시:

version: 0.1
env:
  - name: ALLOW_LIST_PATH
    value: $(volumeMounts:allow-list)/allow-list

위의 예제에서는 컨테이너에서 allow-list 볼륨을 다운로드하고 해당 위치 및 환경 변수 ALLOW_LIST_PATH에 대한 경로를 설정합니다. 기본 동작은 개발 컴퓨터의 임시 디렉터리에서 지정한 경로에 파일을 다운로드하는 것입니다. 위의 예제에서 ALLOW_LIST_PATH는 /TEMPORARY_DIR/allow-list로 설정되어 있습니다.

참고 항목

볼륨을 다운로드하면 설정한 경로에 관계없이 해당 볼륨의 전체 콘텐츠가 다운로드됩니다. 이 경로는 개발용 컴퓨터에서 사용할 환경 변수를 설정하는 데만 사용됩니다. 토큰의 끝에 /allow-list 또는 /path/to/files를 추가하는 것은 실제로 볼륨이 유지되는 위치에 영향을 주지 않습니다. 환경 변수는 앱이 해당 볼륨 내의 특정 파일에 대한 참조를 필요로 하는 경우 사용하기 위한 편의 기능일 뿐입니다.

임시 디렉터리를 사용하는 대신 개발 컴퓨터에 볼륨 탑재를 다운로드할 위치를 지정하는 방법도 있습니다. volumeMounts에서 각 특정 위치에 대한 name 및 localPath를 지정합니다. name은 일치시키려는 볼륨 이름이고 localPath는 개발 컴퓨터의 절대 경로입니다. 예시:

version: 0.1
volumeMounts:
  - name: default-token-*
    localPath: /var/run/secrets/kubernetes.io/serviceaccount
env:
  - name: KUBERNETES_IN_CLUSTER_CONFIG_OVERRIDE
    value: $(volumeMounts:default-token-*)

위의 예제에서는 env의 항목을 사용하여 default-token-1111 또는 default-token-1234-5678-90abcdef와 같이 default-token-*와 일치하는 볼륨을 다운로드합니다. 여러 볼륨이 일치하는 경우 첫 번째 일치하는 볼륨이 사용됩니다. 모든 파일은 volumeMounts의 항목을 사용하여 개발용 컴퓨터의 /var/run/secrets/kubernetes.io/serviceaccount에 다운로드됩니다. KUBERNETES_IN_CLUSTER_CONFIG_OVERRIDE 환경 변수는 /var/run/secrets/kubernetes.io/serviceaccount로 설정되어 있습니다.

서비스를 사용할 수 있도록 설정

env에서 개발용 컴퓨터에서 사용할 수 있도록 설정할 각 서비스에 대해 name 및 value를 지정합니다. name은 개발용 컴퓨터에서 사용할 환경 변수입니다. value는 클러스터의 서비스 이름과 경로입니다. value 값은 $(services:SERVICE_NAME)/PATH 형식입니다.

예시:

version: 0.1
env:
  - name: MYAPP1_SERVICE_HOST
    value: $(services:myapp1)/api/v1/

위의 예제에서는 myapp1 서비스를 개발용 컴퓨터에서 사용할 수 있도록 설정하며, MYAPP1_SERVICE_HOST 환경 변수를 경로가 /api/v1인 myapp1 서비스의 로컬 IP 주소(즉 127.1.1.4/api/v1)로 설정합니다. myapp1 서비스는 환경 변수 myapp1 또는 myapp1.svc.cluster.local을 사용하여 액세스할 수 있습니다.

참고 항목

서비스를 개발용 컴퓨터에서 사용할 수 있도록 설정하면 설정된 경로에 관계없이 전체 서비스를 사용할 수 있게 됩니다. 이 경로는 개발용 컴퓨터에서 사용할 환경 변수를 설정하는 데만 사용됩니다. $(services:SERVICE_NAME.NAMESPACE_NAME)을 사용하여 특정 Kubernetes 네임스페이스의 서비스를 사용할 수 있도록 설정할 수도 있습니다. 예시:

version: 0.1
env:
  - name: MYAPP2_SERVICE_HOST
    value: $(services:myapp2.mynamespace)

위의 예제에서는 mynamespace의 myapp2를 개발용 컴퓨터에서 사용할 수 있도록 설정하며 MYAPP2_SERVICE_HOST 환경 변수를 mynamespace 네임스페이스의 myapp2의 로컬 IP 주소로 설정합니다.

상수 값을 사용하여 환경 변수 만들기

env에서 개발용 컴퓨터에 생성하려는 각 환경 변수에 대해 name 및 value를 지정합니다. name은 개발 컴퓨터에서 사용할 환경 변수이고 value는 값입니다. 예시:

version: 0.1
env:
  - name: DEBUG_MODE
    value: "true"

위의 예제에서는 true 값을 사용하여 DEBUG_MODE라는 환경 변수를 만듭니다.

서비스 종속성 추가

서비스 선언 방법과 유사한 제네릭 종속성 필드를 사용하여 데이터베이스 또는 캐시와 같은 서비스 종속성을 지정할 수 있습니다. 디버그 중인 서비스가 클러스터에서 실행되고 있지 않은 리소스에 연결해야 하는 경우 여기에서 종속성을 지정합니다. 다음 예제와 같이 종속성을 선언합니다.

version: 0.1
volumeMounts:
env:
  - name: DB_HOST
    value: $(externalendpoints:server-bridgetest123.database.windows.net:1433)

종속성에 대한 호스트 DNS 이름(예제에서는 server-bridgetest13.database.windows.net) 및 포트(예제에서는 1433)를 제공합니다.

데이터베이스와 같은 종속성을 지정하면 리디렉션 인증 모델이 작동하지 않습니다. 예를 들어, Azure SQL Database의 경우 연결 정책은 “리디렉션” 또는 “기본값”이 아닌 “프록시”로 설정해야 합니다.

Example KubernetesLocalProcessConfig.yaml

전체 KubernetesLocalProcessConfig.yaml 파일의 예는 다음과 같습니다.

version: 0.1
volumeMounts:
  - name: default-token-*
    localPath: /var/run/secrets/kubernetes.io/serviceaccount
env:
  - name: KUBERNETES_IN_CLUSTER_CONFIG_OVERRIDE
    value: $(volumeMounts:default-token-*)
  - name: ALLOW_LIST_PATH
    value: $(volumeMounts:allow-list)/allow-list
  - name: MYAPP1_SERVICE_HOST
    value: $(services:myapp1)/api/v1/
  - name: MYAPP2_SERVICE_HOST
    value: $(services:myapp2.mynamespace)
  - name: DEBUG_MODE 
    value: "true"

다음 단계

Bridge to Kubernetes를 사용하여 클러스터에 로컬 개발용 컴퓨터를 연결하려면 Visual Studio Code에서 Bridge to Kubernetes 사용 및 Visual Studio에서 Bridge to Kubernetes 사용을 참조하세요.