teleport-agent-azure Terraform 모듈 레퍼런스
Teleport v18.11요약
이 페이지는 teleport-agent-azure Terraform 모듈의 입력 필드와 출력 값을 나열합니다. 이 모듈은 Teleport 에이전트 서비스를 Azure Container Instances(ACI)에 배포합니다.
이 페이지는 teleport-agent-azure Terraform 모듈의 입력 필드와 출력 값을 나열합니다.
Azure Container Instances에 Teleport 에이전트 배포#
이 모듈은 Teleport 에이전트 서비스를 Azure Container Instances(ACI)에 배포합니다.
이 모듈은 Teleport 클러스터나 Auth 서비스 및 프록시 서비스 컨트롤 플레인을 배포하기 위한 것이 아닙니다. 이 모듈은 셀프 호스팅 Teleport 클러스터를 운영하는 데 필요한 영구 백엔드와 감사 이벤트 스토리지, 로드 밸런싱, DNS, TLS 인증서를 프로비저닝하지 않습니다.
현재는 Teleport Kubernetes Service만 배포할 수 있습니다.
사전 요구 사항#
-
Auth 서비스와 프록시 서비스가 있는 기존 Teleport 클러스터
-
접근 가능한 Teleport 프록시 서비스 엔드포인트
-
에이전트 리소스를 위한 기존 Azure 리소스 그룹.
-
Generic OIDC 조인을 지원하는 Teleport 클러스터(v18.11.0 이상)와
teleport.join_params.generic_oidc.http_request를 지원하는 에이전트(v18.11.2 이상).
예시#
이 모듈의 사용 예시는 예시를 참조하십시오.
도움을 받는 방법#
문제가 발생하면 GitHub Discussions를 확인하십시오.
이 코드와 관련된 버그는 이슈를 등록해 주십시오.
요구 사항#
| Name | Version |
|---|---|
| terraform | >= 1.5.7 |
| azurerm | >= 5.0 |
| http | >= 3.0 |
| random | >= 3.0 |
| teleport | >= 18.11.0 |
제공자#
| Name | Version |
|---|---|
| azurerm | >= 5.0 |
| http | >= 3.0 |
| random | >= 3.0 |
| teleport | >= 18.11.0 |
모듈#
모듈이 없습니다.
리소스#
| Name | Type |
|---|---|
| azurerm_container_group.teleport_agent | resource |
| azurerm_log_analytics_workspace.this | resource |
| azurerm_role_assignment.teleport_agent | resource |
| azurerm_role_definition.teleport_agent | resource |
| azurerm_user_assigned_identity.teleport_agent | resource |
| random_string.name_suffix | resource |
| teleport_provision_token.agent | resource |
| azurerm_client_config.this | data source |
| http_http.managed_updates | data source |
입력#
| Name | Description | Type | Default | Required |
|---|---|---|---|---|
| apply_azure_tags | 생성되는 모든 Azure 리소스에 적용할 추가 Azure 태그입니다. | map(string) |
{} |
no |
| container_group_cpu | 컨테이너에 필요한 CPU 코어 수입니다. | number |
2 |
no |
| container_group_desired_count | 실행할 Teleport 컨테이너 그룹의 원하는 개수입니다. | number |
2 |
no |
| container_group_memory | 컨테이너에 필요한 메모리(GB)입니다. | number |
4 |
no |
| container_group_name | 에이전트가 실행되는 컨테이너 그룹의 이름입니다. | string |
"teleport-agent" |
no |
| container_group_use_name_prefix | var.container_group_name을 컨테이너 그룹 이름의 접두사로 사용할지 결정합니다. 컨테이너 그룹 이름에는 항상 리비전과 복제본 인덱스가 덧붙습니다. |
bool |
true |
no |
| create | 모든 리소스의 생성 여부를 전환합니다. | bool |
true |
no |
| environment_vars | Teleport Azure Container Instance에 설정할 환경 변수입니다. | map(string) |
{} |
no |
| kubernetes_service | 이 에이전트를 Kubernetes Service로 실행하기 위한 구성입니다. resource_matcher_labels는 필수이며, 쿠버네티스 리소스를 매칭하고 프록시하기 위한 라벨 선택자를 포함합니다. |
object({ enabled = optional(bool, true) resource_matcher_labels = optional(map(list(string)), {}) }) |
n/a | yes |
| location | 에이전트의 Azure 위치입니다. 예: eastus, westus. | string |
n/a | yes |
| log_analytics_workspace_name | Teleport 컨테이너용 Log Analytics 워크스페이스의 이름입니다. | string |
"teleport" |
no |
| log_analytics_workspace_retention_days | 생성된 Log Analytics 워크스페이스에 컨테이너 로그를 보존하는 기간(일)입니다. | number |
30 |
no |
| log_analytics_workspace_use_name_prefix | log_analytics_workspace_name을 Log Analytics 워크스페이스 이름의 접두사로 사용할지 결정합니다. | bool |
true |
no |
| managed_identity_role | 에이전트의 관리 ID에 대한 사용자 지정 역할입니다. 기본값은 구성된 서비스에 대한 권한이며, 제공자의 구독으로 범위가 지정됩니다. 필요에 따라 actions, data_actions 또는 scopes를 재정의하십시오. null로 설정하면 역할 생성과 할당이 비활성화됩니다. | object({ actions = optional(list(string)) data_actions = optional(list(string)) scope = optional(string) }) |
{} |
no |
| managed_updates_enabled | 이 모듈을 적용할 때 구성된 Managed Updates 엔드포인트에서 Teleport 버전을 확인할지 여부입니다. | bool |
true |
no |
| managed_updates_group | v2 Managed Updates 엔드포인트를 통해 조회할 업데이트 그룹입니다. | string |
"default" |
no |
| resource_group_name | 리소스가 생성될 리소스 그룹입니다. 이미 존재해야 합니다. | string |
n/a | yes |
| subnet_id | 프라이빗 AKS 클러스터에 대한 접근을 설정할 때는 subnet_id를 Azure Container Instance를 호스팅할 서브넷의 리소스 ID로 설정합니다. 이 서브넷은 Microsoft.ContainerInstance/containerGroups에 위임되어야 하며 다음에 접근할 수 있어야 합니다. - Teleport 프록시 서비스(var.teleport_proxy_addr) - https://public.ecr.aws/ 의 Teleport 이미지 레지스트리 - 클러스터 세부 정보를 읽고 자격 증명을 가져오기 위한 https://management.azure.com/ 의 Azure Resource Manager(HTTPS/TCP 443) - 대상 AKS API 엔드포인트(DNS 확인 및 연결) 이 모듈은 이러한 네트워킹 리소스를 프로비저닝하지 않습니다. 생략하거나 null이면 컨테이너 그룹에 서브넷이 지정되지 않습니다. | string |
null |
no |
| teleport_container_image | Teleport Azure Container Instance 작업에 사용하는 컨테이너 이미지입니다. | string |
"public.ecr.aws/gravitational/teleport-ent-distroless" |
no |
| teleport_discovery_group_name | 지정하면 resource_matcher_labels의 일부로 추가되어, 해당 디스커버리 그룹에서 탐지된 리소스를 매칭합니다. |
string |
"" |
no |
| teleport_proxy_public_addr | Teleport 클러스터 프록시의 퍼블릭 주소 host:port입니다. |
string |
n/a | yes |
| teleport_version_override | teleport_version_override는 개발용이며, 일반적인 배포에서 Teleport 버전을 제어하는 데 사용해서는 안 됩니다. 이 모듈은 특정 Teleport 버전을 실행하도록 설계되었으므로 다른 Teleport 버전을 실행하려고 하면 호환성 문제가 발생합니다. Teleport 버전 X.Y.Z를 실행하려면 대신 모듈 버전을 X.Y.Z로 조정하십시오. |
string |
null |
no |
출력#
| Name | Description |
|---|---|
| container_group_ids | 배포된 에이전트의 리소스 ID이며, 복제본마다 하나씩입니다. |
| container_group_names | 배포된 에이전트의 이름이며, 복제본마다 하나씩입니다. |
| container_group_urls | 배포된 각 에이전트의 배포 상태와 컨테이너 로그를 볼 수 있는 Azure 포털 URL입니다. |
| container_logs_follow_command | 배포된 에이전트 컨테이너의 로그를 따라가는 명령입니다. |
| log_analytics_workspace_id | 에이전트 로그를 수집하는 Log Analytics 워크스페이스의 리소스 ID입니다. |
| log_analytics_workspace_name | 에이전트 로그를 수집하는 Log Analytics 워크스페이스의 이름입니다. |
| managed_identity | 배포된 에이전트가 사용하는 사용자 할당 관리 ID입니다. |