소스 코드: github.com/gravitational/teleport/tree/master/integrations/terraform-modules/teleport/discovery/aws

AWS Discovery Terraform 모듈#

이 Terraform 모듈은 Teleport 클러스터가 AWS 리소스를 검색하는 데 필요한 AWS 및 Teleport 클러스터 리소스를 생성합니다.

• Teleport Discovery Service가 어슘(assume)할 AWS IAM 역할.
• Teleport가 AWS에서 리소스를 검색하는 데 필요한 AWS 권한을 부여하는, IAM 역할에 연결된 AWS IAM 정책.
• Teleport Discovery Service가 OIDC를 사용하여 IAM 역할을 어슘하기 위한 AWS OIDC 공급자. 이 리소스는 선택 사항이며, create_aws_iam_openid_connect_provider = false로 설정하면 생성을 비활성화할 수 있습니다. 이 리소스가 선택 사항인 이유는 다음 두 가지 시나리오를 지원하기 위해서입니다:
  • AWS 계정에 이미 Teleport 클러스터의 프록시 URL을 사용하도록 구성된 AWS IAM OIDC 공급자가 존재하는 경우. AWS는 고유 URL당 하나의 AWS IAM OIDC 공급자만 허용하므로, 이미 해당 공급자를 관리하고 있다면 이 모듈은 동일한 Teleport 클러스터에 대해 또 다른 공급자를 생성할 수 없습니다.
  • Teleport 클러스터의 프록시 URL에 접근할 수 없어 AWS IAM OIDC 페더레이션이 불가능한 경우. 이 경우 Teleport Discovery Service 인스턴스에 대해 AWS IAM 역할 자격 증명을 구성하고, discovery_service_iam_credential_source를 해당 역할을 신뢰하도록 설정해야 합니다.
• AWS 리소스 검색을 위해 Teleport를 구성하는 Teleport discovery_config 클러스터 리소스.
• AWS OIDC를 위한 Teleport integration 클러스터 리소스.
• Teleport 노드가 AWS IAM 자격 증명을 사용하여 클러스터에 조인할 수 있도록 하는 Teleport token 클러스터 리소스.

사전 요구사항#

• Teleport Terraform 공급자 구성
• AWS Terraform 공급자 구성

사용법#

module "aws_discovery" {
  source = "terraform.releases.teleport.dev/teleport/discovery/aws"

  # Your Teleport cluster public proxy address - host:port format is required.
  teleport_proxy_public_addr = "example.teleport.sh:443"
  # Teleport Discovery Service instances in this discovery group will be configured to discover AWS resources.
  # "cloud-discovery-group" is the group name of the discovery service instances running in Teleport Cloud clusters.
  teleport_discovery_group_name = "cloud-discovery-group"

  # apply additional tags to the AWS resources created by the module
  apply_aws_tags = {
    Terraform = "true"
    Env       = "dev"
  }

  # Configure matchers to discover EC2 instances and EKS clusters.
  aws_matchers = [
    {
      types   = ["ec2"]
      # EC2 discovery supports wildcard to find instances in all regions.
      regions = ["*"]
      tags = {
        origin = ["example"]
      }
    },
    {
      types   = ["eks"]
      regions = ["*"]
      tags = {
        team = ["platform"]
      }
    }
  ]
}

aws_matchers 필드#

도움을 받는 방법#

문제가 발생하면 GitHub Discussions를 확인하세요.

이 코드와 관련된 버그는 이슈를 등록해 주세요.

Requirements#

Providers#

Modules#

모듈 없음.

Resources#

Inputs#

Outputs#