Terraform으로 VPC 배포
Infrastructure Manager 및Google Cloud 콘솔을 사용하여 가상 프라이빗 클라우드(VPC) 네트워크를 배포할 수 있습니다. 이 빠른 시작은 Google Cloud 인프라를 코드형 인프라로 관리하려는 클라우드 관리자, 플랫폼 엔지니어, 개발자를 대상으로 합니다. VPC 네트워크는 가상 머신(VM) 인스턴스, 데이터베이스, 앱과 같은 리소스에 격리된 네트워킹을 제공합니다.
Infra Manager를 사용하면 네트워크를 수동으로 만드는 대신 Terraform 구성에서 네트워크를 정의합니다. Infra Manager는 Terraform을 실행하고 Terraform 상태를 저장합니다. 따라서 인프라를 일관되게 재현, 업데이트, 삭제할 수 있습니다. 자세한 내용은 Google Cloud의 Terraform 개요를 참조하세요.
이 빠른 시작에서는 공개 GitHub 저장소의 Terraform 구성에서 배포를 미리 보고 만듭니다.
시작하기 전에
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Infrastructure Manager and Compute Engine APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
필요한 역할
이 빠른 시작을 완료하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
- Cloud Infrastructure Manager 관리자(
roles/config.admin) - 서비스 계정 관리자(
roles/iam.serviceAccountAdmin) - 서비스 계정 사용자(
roles/iam.serviceAccountUser) - 프로젝트 IAM 관리자(
roles/resourcemanager.projectIamAdmin) - Compute 네트워크 뷰어(
roles/compute.networkViewer) - Cloud Build 뷰어(
roles/cloudbuild.builds.viewer) - 스토리지 객체 뷰어(
roles/storage.objectViewer)
역할 부여 방법에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
배포 미리보기 및 만들기
배포를 만들면 Infra Manager가 Terraform 구성에 정의된 리소스를 프로비저닝합니다. 배포를 만들기 전에 미리보기를 만들어 Infra Manager가 프로비저닝할 리소스를 확인합니다.
VPC 네트워크를 프로비저닝하는 배포를 미리 보고 만들려면 다음을 수행합니다.
Google Cloud 콘솔에서 Infrastructure Manager 페이지로 이동합니다.
새 배포 만들기를 클릭합니다.
새 Terraform 배포 만들기 페이지의 배포 세부정보 섹션에서 다음 값을 입력합니다.
- 배포 ID:
quickstart-preview - 리전:
us-central1 - Terraform 버전:
1.5.7 서비스 계정:
im-quickstart-sa라는 새 서비스 계정을 만듭니다. 서비스 계정을 만들고 필요한 역할을 부여하려면 다음을 수행합니다.- 서비스 계정 목록에서 새 서비스 계정을 클릭합니다. 새 탭에서 서비스 계정 만들기 페이지가 열립니다.
- 서비스 계정 이름 필드에
im-quickstart-sa를 입력한 후 만들고 계속하기를 클릭합니다. 이 서비스 계정에 프로젝트에 대한 액세스 권한 부여 섹션에서 역할 선택 목록을 사용하여 다음 역할을 부여합니다. 두 번째 역할을 추가하려면 다른 역할 추가를 클릭합니다.
- Cloud Infrastructure Manager 에이전트(
roles/config.agent): Infra Manager가 Terraform을 실행하고 배포의 상태와 로그를 저장할 수 있습니다. - Compute 네트워크 관리자(
roles/compute.networkAdmin): Infra Manager가 VPC 네트워크를 만들고 관리할 수 있습니다.
Infra Manager 역할에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.
- Cloud Infrastructure Manager 에이전트(
계속을 클릭한 다음 완료를 클릭합니다.
탭을 닫고 새 Terraform 배포 만들기 페이지로 돌아갑니다.
서비스 계정 목록에서 목록 새로고침을 클릭한 후
im-quickstart-sa를 선택합니다.
Terraform 구성의 소스: Git
Git 저장소:
https://github.com/terraform-google-modules/terraform-google-networkGit 디렉터리:
modules/vpc
- 배포 ID:
계속을 클릭합니다.
Terraform 세부정보 섹션의 입력 값에서 자동 입력된 모듈 변수에 다음 값을 입력합니다.
project_id키의 행에 있는 값 필드에<var>PROJECT_ID</var>를 입력합니다. 따옴표를 포함하지 마세요.network_name키의 행에 있는 값 필드에quickstart-vpc를 입력합니다. 따옴표를 포함하지 마세요.
PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.
미리보기 만들기를 클릭합니다.
quickstart-preview-<var>UUID</var>미리보기의 세부정보 페이지에서 상태 행의 값이 성공인지 확인합니다.미리보기의 값을 사용하는 배포를 만들려면 배포 만들기를 클릭합니다.
배포 ID 필드에
quickstart-deployment를 입력합니다.배포 만들기를 클릭합니다.
Infra Manager가 VPC 네트워크를 프로비저닝합니다. 배포가 완료되면 Google Cloud 콘솔에 알림이 표시됩니다.
Infra Manager를 사용하여 배포를 만들었습니다. 다음 섹션에서는 배포를 확인하고, 프로비저닝된 네트워크를 보고, Terraform을 실행한 Cloud Build 작업을 검토합니다.
배포 상태 보기
Infra Manager가 배포를 만든 후에는 상태, 최신 버전, Terraform 구성 소스와 같은 세부정보를 볼 수 있습니다.
배포 세부정보를 보려면 다음을 수행합니다.
Google Cloud 콘솔에서 Infrastructure Manager 페이지로 이동합니다.
ID 열에서
quickstart-deployment를 클릭합니다.배포 세부정보 페이지에서 상태 행의 값이 활성인지 확인합니다.
프로비저닝된 VPC 네트워크 보기
Infra Manager가 Terraform 구성에서 정의하는 네트워크를 프로비저닝했는지 확인하려면 Google Cloud 콘솔에서 네트워크를 확인합니다.
Google Cloud 콘솔에서 VPC 네트워크 페이지로 이동합니다.
네트워크 목록에는 Infra Manager가 프로비저닝한 네트워크인
quickstart-vpc가 포함됩니다. 목록에는 서브넷 생성 모드, 최대 전송 단위(MTU), 동적 라우팅 모드와 같은 네트워크에 대한 세부정보가 표시됩니다.서브넷, 방화벽 규칙, 경로와 같은 네트워크에 대한 세부정보를 보려면
quickstart-vpc를 클릭합니다.
Cloud Build에서 빌드 결과 보기
Infra Manager는 Cloud Build를 사용하여 각 배포 버전에 대해 Terraform을 실행합니다. 배포를 만든 Terraform 명령어를 검사하거나 실패한 배포 문제를 해결하려면 Cloud Build 빌드 로그를 확인합니다.
Google Cloud 콘솔에서 빌드 기록 페이지로 이동합니다.
빌드 테이블에서
us-central1리전이 있는 최신 빌드를 찾습니다.quickstart-preview-<var>UUID</var>미리보기와quickstart-deployment배포의 빌드가 모두 이 목록에 표시됩니다.빌드 ID를 클릭하여 빌드 세부정보 페이지를 엽니다.
빌드 세부정보 페이지에는 각 빌드 단계의 상태와 Terraform 명령어의 출력이 포함된 빌드 로그가 표시됩니다. 배포가 실패하면 빌드 로그를 사용하여 원인을 파악합니다. 자세한 내용은 배포 오류 문제 해결을 참조하세요.
Infra Manager의 배포 세부정보 페이지에서 Cloud Build 로그 링크를 클릭하여 배포 빌드를 열 수도 있습니다.
삭제
이 빠른 시작에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 더 이상 필요하지 않은 배포를 삭제하세요. 배포 미리보기는 Google Cloud 계정에 요금이 청구되지 않습니다. 미리보기를 삭제하려면 미리보기 삭제를 참조하세요.
배포 삭제
배포 및 프로비저닝된 VPC 네트워크를 삭제합니다.
배포를 삭제하려면 다음을 수행합니다.
Google Cloud 콘솔에서 Infrastructure Manager 페이지로 이동합니다.
ID 열에서
quickstart-deployment를 클릭합니다.배포 세부정보 페이지에서 삭제를 클릭합니다.
확인 대화상자에서
quickstart-deployment을 입력한 후 확인을 클릭합니다.
서비스 계정 삭제
Infra Manager가 배포를 삭제한 후 프로젝트에서 역할을 유지하지 않도록 im-quickstart-sa 서비스 계정을 삭제합니다.
Google Cloud 콘솔에서 서비스 계정 페이지로 이동합니다.
im-quickstart-sa체크박스를 선택한 후 삭제를 클릭합니다.대화상자에서 삭제를 클릭합니다.
선택사항: 프로젝트 삭제
새 Google Cloud 프로젝트에서 배포를 만들었지만 프로젝트가 더 이상 필요하지 않으면 프로젝트를 삭제합니다.
Google Cloud 콘솔에서 리소스 관리 페이지로 이동합니다.
프로젝트 목록에서 삭제하려는 프로젝트를 선택한 후 삭제를 클릭합니다.
대화상자에서 프로젝트 ID를 입력한 후 종료를 클릭합니다.
다음 단계
- Infra Manager 작동 방식 알아보기
- Terraform 및 Infra Manager 자세히 알아보기
- 배포 업데이트
- 배포 자동화.
- Google Cloud에서 사용할 수 있는 구성 및 모듈 집합은 Google Cloud 의 Terraform 문서에서 Google Cloud용 Terraform 청사진 및 모듈을 참조하세요.