Terraform 모듈 구성

이 솔루션에 필요한 모든 컴퓨트, 네트워킹 및 스토리지 인프라 리소스는 Terraform 모듈에 정의됩니다.

시작하기 전에

Terraform 모듈 구성을 시작하기 전에 다음 단계를 완료하십시오.

  1. Terraform의 기본 사항에 대해 알아봅니다.

    최소한 Terrraform 설명서의 소개를 읽어보십시오.

  2. 다음 정보를 준비해 둡니다.
    • 테넌시의 OCID입니다.

      Oracle Cloud Infrastructure 웹 콘솔에서 테넌시의 OCID를 찾을 수 있습니다. 서비스 메뉴에서 관리 를 선택한 다음 테넌시 세부정보 를 누릅니다.

    • Terraform에서 Oracle Cloud Infrastructure을 사용하여 인증하는 데 사용할 사용자의 OCID입니다.

      사용자의 OCID를 찾으려면 서비스 메뉴에서 id를 선택한 다음 사용자 를 선택합니다. 목록에서 사용자 이름을 찾아 OCID를 복사합니다.

    • 리소스를 생성할 구획의 OCID입니다.

      구획의 OCID를 찾으려면 서비스 메뉴에서 id를 선택한 다음 구획 을 선택합니다. 목록에 필요한 구획을 찾아 OCID를 복사합니다.

    • 리소스를 생성할 영역의 ID입니다.

      예를 들어, US East(Ashburn) 영역의 ID는 us-ashburn-1 입니다.

      지역 및 가용성 도메인 을 참조하십시오.

  3. 다음을 결정합니다.
  4. 테넌시의 서비스 제한이 생성할 모든 리소스를 수용할 수 있는지 확인합니다.

Terraform 코드 다운로드

이 솔루션에 대한 Terraform 코드는 GitHub에서 제공됩니다.

  1. 왼쪽 탐색 창에서 코드 다운로드 를 누릅니다.
  2. Git 저장소 를 누릅니다.
  3. 로컬 컴퓨터에 저장소를 복제하거나 다운로드합니다.

Terraform 코드 정보

다운로드한 Terraform 코드의 구조는 다음과 같습니다.

├── oci-hyperion-master
│   ├── _docs
│   ├── *.tf
│   ├── env-vars
│   ├── LICENSE.md
│   ├── modules
│   │   ├── bastion
│   │   ├── compute
│   │   ├── dbsystem
│   │   ├── filesystem
│   │   ├── loadbalancer
│   │   └── network
│   ├── orm
│   ├── README.md
│   ├── schema.yaml
│   ├── terraform.tfvars
│   ├── userdata
  • _docs 디렉토리: 구조 다이어그램을 포함합니다.
  • *.tf: 솔루션이 사용하는 Terraform 구성 파일입니다. 이러한 파일은 편집하지 마십시오.
  • env-vars: Terraform에 대한 환경 변수를 설정하는 스크립트입니다.
  • LICENSE.md: 코드에 대한 라이센스 조건입니다.
  • modules: 이 솔루션을 사용하여 생성한 리소스에 대한 핵심 Terraform 구성이 포함된 디렉토리입니다. 편집하지 마십시오.
  • orm: Terraform를 사용하여 솔루션을 배치하는 대신 Oracle Cloud Infrastructure Resource Manager에서 스택을 생성하는 데 사용할 수 있는 zip 파일을 포함합니다.
  • README.md: 코드에 대한 Quick-start 설명서
  • schema.yaml: Terraform 코드에 사용되는 변수의 제약 조건 및 검증입니다. 이 파일은 Oracle 리소스 관리자를 사용하여 리소스를 배치할 때 사용됩니다. 이 파일은 편집하지 마십시오.
  • terraform.tfvars: Terraform 변수입니다. 나중에 이 파일에서 변수의 값을 설정합니다.
  • userdata: 컴퓨트 인스턴스가 생성된 후 컴퓨트 인스턴스에서 실행되는 스크립트를 포함합니다. 이 디렉토리의 파일을 편집하지 마십시오.

Terraform 환경 변수 설정

Terraform 코드에는 특정 Terraform 매개변수의 값을 환경 변수로 저장하는 데 사용할 수 있는 스크립트 파일이 포함되어 있습니다.

  1. 앞에서 설명한 필요 조건을 완료했는지 확인합니다.
    시작하기 전에 를 참조하십시오.
  2. 로컬 컴퓨터에서 Terraform 코드를 다운로드한 디렉토리로 이동합니다.
  3. 코드의 최상위 레벨 디렉토리에서 일반 텍스트 편집기에서 env-vars 파일을 찾아 엽니다.
  4. 파일에 있는 변수에 적합한 값을 입력합니다.

    주:

    각 변수에 대해 값을 지정할 때 행 주석 처리를 해제하십시오. 즉, 행 시작 부분에 #(해시) 문자가 제거됩니다.
  5. 지정한 값을 확인하십시오.
    값을 생략하면 Terraform를 실행할 때 입력 메시지가 표시됩니다. 잘못된 값을 제공하면 Terraform에서 오류가 발생합니다.
  6. 모든 값이 올바르면 파일을 저장하고 닫습니다.
  7. 다음 명령을 실행하여 환경 변수 파일이 포함된 디렉토리에서 다음 명령을 실행하여 환경 변수를 설정합니다.
    source ./env-vars
  8. 다음 명령을 실행하여 환경 변수를 모두 설정했는지 확인합니다.
    env | grep TF
    설정한 환경 변수가 표시됩니다.

배치 매개변수 설정

생성할 컴퓨트, 네트워킹, 데이터베이스 및 저장소 리소스와 해당 속성을 지정합니다.

  1. 앞에서 설명한 필요 조건을 완료했는지 확인합니다.
    시작하기 전에 를 참조하십시오.
  2. 다운로드하거나 복제된 코드의 최상위 레벨 디렉토리에서 terraform.tfvars 파일을 찾아서 일반 텍스트 편집기에서 엽니다.
  3. terraform.tfvars에 나열된 변수의 값을 설정합니다.
    다운로드한 코드의 README 파일에는 변수에 대한 설명이 포함되고 완료된 terraform.tfvars 파일의 샘플이 포함됩니다.
  4. terraform.tfvars을 저장하고 닫습니다.