teleport-plugin-jira Helm 차트는 Jira Teleport 플러그인을 실행하며, 사용자가 Jira 프로젝트의 작업으로 Access Request를 수신하고 관리할 수 있도록 합니다.

GitHub에서 소스를 탐색할 수 있습니다.

이 레퍼런스는 teleport-plugin-jira 차트에서 사용 가능한 값들을 상세히 설명합니다.

teleport#

teleport는 플러그인이 Teleport 클러스터에 연결하는 방식을 설명하는 구성을 포함합니다.

teleport.address#

teleport.address는 플러그인이 연결하는 Teleport 클러스터의 주소입니다. 이 주소는 Teleport 클러스터의 도메인 이름과 포트를 모두 포함해야 합니다. auth 서버의 주소일 수도 있고 proxy 서버의 주소일 수도 있습니다.

예를 들면 다음과 같습니다:

• Proxy에 조인하는 경우: teleport.example.com:443 또는 teleport.example.com:3080
• Auth에 조인하는 경우: teleport-auth.example.com:3025 주소가 비어 있으면, tbot.teleportProxyAddress 또는 tbot.teleportAuthAddress가 설정되어 있는 경우 해당 값이 사용됩니다.

teleport.identityFromSecret#

teleport.identityFromSecret은 Teleport 클러스터 연결에 사용할 자격 증명을 포함하는 Kubernetes secret의 이름입니다.

secret은 다음 형식이어야 합니다:

apiVersion: v1
kind: Secret
type: Opaque
metadata:
  name: teleport-plugin-identity
data:
  auth_id: #...

이러한 자격 증명을 얻는 방법에 대한 자세한 내용은 Access Requests with Jira 가이드를 참고하세요.

teleport.identitySecretPath#

teleport.identitySecretPath는 teleport.identitySecretName으로 지정된 Kubernetes secret에서 Teleport 클러스터 연결용 자격 증명을 담고 있는 키입니다. secret에 "auth_id" 경로가 있다면 이 필드는 생략할 수 있습니다.

jira#

jira는 플러그인이 Jira에 인증하고 이슈를 여는 데 사용하는 구성을 포함합니다.

Jira apiToken은 다음과 같이 전달할 수 있습니다:

• 차트 Values에서 jira.apiToken을 설정하여 전달
• 기존 Kubernetes Secret을 통해 jira.apiTokenFromSecret을 설정하여 전달

jira.url#

jira.url은 Jira URL입니다. 예를 들면 다음과 같습니다:

• 셀프 호스팅 Jira 인스턴스 URL은 https://jira.example.com/과 같은 형태입니다.
• Jira Cloud URL은 https://[your-jira].atlassian.net과 같은 형태입니다.

jira.url#

jira.url은 API 토큰과 연결된 Jira 사용자 이름 또는 이메일 주소입니다.

jira.apiToken#

jira.apiToken은 플러그인이 Jira와 상호작용하는 데 사용하는 Jira apiToken입니다. 설정하면 차트가 Kubernetes Secret을 자동으로 생성합니다.

jira.apiTokenFromSecret이 설정된 경우 이 값은 효과가 없습니다.

jira.apiTokenFromSecret#

jira.apiTokenFromSecret은 Jira apiToken을 담고 있는 Kubernetes Secret의 이름입니다. 이 값을 설정한 경우, 차트 릴리스를 생성하기 전에 Secret을 먼저 생성해야 합니다.

jira.apiTokenSecretPath#

jira.apiTokenSecretPath는 Jira apiToken을 담고 있는 Kubernetes Secret의 키입니다. secret 이름은 jira.apiTokenFromSecret을 통해 설정합니다.

jira.project#

jira.project는 이슈가 열리는 Jira 프로젝트입니다. 이 값은 필수입니다.

jira.issueType#

jira.issueType은 Jira 이슈를 열 때 사용되는 이슈 유형입니다.

http#

http는 웹훅 구성을 포함합니다. Jira에서 이슈가 업데이트되면(승인 또는 거부), Jira는 웹훅을 통해 플러그인에 연락하여 Teleport Access Request 승인을 트리거합니다.

http.publicAddress#

http.publicAddress는 콜백 서버가 외부에서 접근 가능한 URL이며, 예를 들어 [https://]teleport-proxy.example.com과 같습니다.

http.tlsFromSecret#

http.tlsFromSecret은 웹훅 서버가 사용하는 TLS 개인 키와 인증서를 담고 있는 Kubernetes Secret의 이름입니다.

http.tlsKeySecretPath#

http.tlsKeySecretPath는 웹훅 서버가 사용하는 TLS 개인 키를 담고 있는 Kubernetes Secret의 필드입니다.

http.tlsCertSecretPath#

http.tlsCertSecretPath는 웹훅 서버가 사용하는 TLS 인증서를 담고 있는 Kubernetes Secret의 필드입니다.

chartMode#

chartMode는 클라우드별 헬퍼를 활성화합니다. aws가 유일하게 지원되는 값입니다. chartMode가 aws이면, 생성된 서비스에 in-tree AWS LB 컨트롤러 어노테이션이 적용됩니다.

log#

log는 플러그인 로깅을 제어합니다.

log.severity#

log.severity는 Teleport 프로세스의 로그 레벨입니다. 사용 가능한 로그 레벨은 DEBUG, INFO, WARN, ERROR입니다.

기본값은 INFO이며, 프로덕션 환경에서 권장됩니다. DEBUG는 최초 설정 시 또는 디버깅을 위해 더 상세한 로그를 확인할 때 유용합니다.

log.output#

log.output은 Teleport 프로세스의 출력 대상을 설정합니다. stdout, stderr와 같은 기본 제공 값 중 하나로 설정할 수 있습니다.

이 값은 파일 경로(예: /var/log/teleport.log)로 설정하여 로그를 파일에 기록할 수도 있습니다. 다만 몇몇 서비스 시작 메시지는 복원력을 위해 여전히 stderr로 전송된다는 점에 유의하세요.

tbot#

tbot은 플러그인이 Teleport에 연결하기 위한 자격 증명을 획득하고 갱신하는 선택적 tbot 배포를 제어합니다. 여기에는 기본값과 필수값만 설명되어 있으며, 지원되는 전체 값 목록은 tbot 차트 레퍼런스를 참고하세요.

tbot.enabled#

tbot.enabled는 Jira 플러그인과 함께 tbot을 배포할지 여부를 제어합니다.

tbot.clusterName#

tbot.clusterName은 tbot과 Jira 플러그인이 조인할 Teleport 클러스터의 이름입니다. tbot이 활성화된 경우 이 값을 설정하는 것은 필수입니다.

tbot.teleportProxyAddress#

tbot.teleportProxyAddress는 봇이 연결할 Teleport Proxy Service 주소입니다. 포트 번호를 포함해야 하며, Proxy Service의 경우 일반적으로 443 또는 3080입니다. Proxy Service에 연결하는 것이 가장 일반적이고 권장되는 Teleport 연결 방식입니다. Teleport Enterprise (Cloud)에 연결하려면 이 값이 필수입니다.

이 설정은 teleportAuthAddress와 상호 배타적입니다.

예를 들면 다음과 같습니다:

tbot:
  teleportProxyAddress: "test.teleport.sh:443"

tbot.teleportAuthAddress#

tbot.teleportAuthAddress는 봇이 연결할 Teleport Auth Service 주소입니다. 포트 번호를 포함해야 하며, Auth Service의 경우 일반적으로 3025입니다. 직접 Auth Service 연결은 봇을 teleport-cluster Helm 릴리스와 동일한 Kubernetes 클러스터에 배포하고 Auth Service에 직접 접근할 수 있는 경우에 사용해야 합니다. 그렇지 않은 경우 Proxy Service를 통해 연결하는 것을 우선하세요.

이 설정은 teleportProxyAddress와 상호 배타적입니다.

예를 들면 다음과 같습니다:

teleportAuthAddress: "teleport-auth.teleport-namespace.svc.cluster.local:3025"

tbot.joinMethod#

tbot.joinMethod는 tbot이 Teleport 클러스터에 조인하는 방식을 설명합니다. 지원되는 값 목록과 자세한 설명은 조인 방식 레퍼런스를 참고하세요.

annotations#

annotations는 차트가 생성하는 다양한 Kubernetes 객체에 적용할 어노테이션을 포함합니다. 자세한 내용은 Kubernetes 어노테이션 문서를 참고하세요.

annotations.config#

annotations.config는 차트가 생성하는 ConfigMap 리소스에 적용되는 Kubernetes 어노테이션을 포함합니다.

annotations.deployment#

annotations.deployment는 차트가 생성하는 Deployment 또는 StatefulSet 리소스에 적용되는 Kubernetes 어노테이션을 포함합니다.

annotations.pod#

annotations.pod는 차트가 생성하는 Pod 리소스에 적용되는 Kubernetes 어노테이션을 포함합니다.

annotations.secret#

annotations.secret은 차트가 생성하는 Secret 리소스에 적용되는 Kubernetes 어노테이션을 포함합니다. joinTokenSecret.create가 false인 경우 이 값은 효과가 없습니다.

annotations.service#

annotations.service는 차트가 생성하는 Service 리소스에 적용되는 Kubernetes 어노테이션을 포함합니다.

image#

image는 차트가 생성하는 플러그인 pod에 사용되는 컨테이너 이미지를 설정합니다.

Teleport가 게시한 이미지 대신 자체 플러그인 이미지를 사용하도록 재정의할 수 있습니다.

image.repository#

image.repository는 이미지 저장소입니다.

image.pullPolicy#

image.pullPolicy는 Kubernetes 이미지 풀 정책입니다.

image.tag#

image.tag는 기본값이 차트 appVersion인 이미지 태그를 재정의합니다.

일반적으로 Teleport 플러그인의 버전은 차트 버전과 일치합니다. 차트 버전 15.0.0을 설치하면 플러그인 버전 15.0.0을 사용합니다. 플러그인 업그레이드는 차트를 업그레이드하여 수행합니다.

imagePullSecrets#

imagePullSecrets는 프라이빗 Docker 레지스트리에 접근하는 데 선택적으로 사용할 수 있는 인증 토큰을 담고 있는 secret의 목록입니다.

자세한 내용은 Kubernetes 레퍼런스를 참고하세요.

podSecurityContext#

podSecurityContext는 차트가 생성하는 모든 pod의 pod 보안 컨텍스트를 설정합니다. 자세한 내용은 Kubernetes 문서를 참고하세요.

보안 컨텍스트를 해제하려면 null 또는 ~로 설정하세요.

securityContext#

securityContext는 차트가 생성하는 모든 pod의 컨테이너 보안 컨텍스트를 설정합니다. 자세한 내용은 Kubernetes 문서를 참고하세요.

보안 컨텍스트를 해제하려면 null 또는 ~로 설정하세요.

resources#

resources는 차트가 생성하는 모든 pod의 리소스 요청/제한을 설정합니다. 자세한 내용은 Kubernetes 문서를 참고하세요.

nodeSelector#

nodeSelector는 차트가 생성하는 모든 pod의 노드 셀렉터를 설정합니다. 자세한 내용은 Kubernetes 문서를 참고하세요.

tolerations#

tolerations는 차트가 생성하는 모든 pod의 톨러레이션을 설정합니다. 자세한 내용은 Kubernetes 문서를 참고하세요.

affinity#

affinity는 차트가 생성하는 모든 pod의 어피니티를 설정합니다. 자세한 내용은 Kubernetes 문서를 참고하세요.

serviceType#

serviceType은 차트가 생성하는 Kubernetes Service 리소스의 서비스 유형을 설정합니다.