단일 프로젝트 설정

이 문서에서는 애플리케이션을 관리하기 위해 단일 Google Cloud 프로젝트를 설정하는 방법을 설명합니다. 이 구성을 단일 프로젝트 경계라고도 합니다.

이 설정에서 Google Cloud 프로젝트는 자체 애플리케이션과 구성요소를 관리하도록 구성되어 독립형 관리 프로젝트 역할을 합니다. 이 접근 방식은 모든 애플리케이션 구성요소가 이 단일 프로젝트 내에 있는 경우 애플리케이션 관리를 시작하는 가장 빠른 방법입니다. App Hub는 프로젝트 내에서 지원되는 모든 리소스를 자동으로 검색하여 애플리케이션으로 구성할 수 있도록 준비합니다.

제한사항

단일 프로젝트 경계는 폴더 수준 경계와 비교할 때 기능 지원이 다릅니다. App Hub, App Design Center, Application Monitoring은 단일 프로젝트를 완전히 지원하지만 Cloud Hub, Gemini Cloud Assist와 같은 기타 애플리케이션 중심 Google Cloud 서비스에는 폴더 수준 경계가 필요합니다.

단일 프로젝트 모델과 폴더 수준 모델 간의 기능 지원 비교는 경계 유형별 기능 지원을 참고하세요.

시작하기 전에

애플리케이션 관리에 사용할 Google Cloud 프로젝트를 선택합니다. 이 프로젝트는 독립형 관리 프로젝트로 작동합니다. 기존 프로젝트를 사용하거나 새 프로젝트를 만들 수 있습니다.

필요한 역할

애플리케이션 관리를 위해 단일 프로젝트를 구성하는 데 필요한 권한을 얻으려면 관리자에게 독립형 관리 프로젝트로 구성하려는 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

프로젝트에서 애플리케이션 관리 사용 설정

이 작업은 프로젝트를 독립형 관리 프로젝트로 구성하고 애플리케이션 메타데이터 및 구성에 필요한 API를 사용 설정합니다. 이 프로젝트를 앱 지원 프로젝트라고 합니다.

단일 프로젝트에서 애플리케이션 관리를 사용 설정하려면 다음 단계를 따르세요.

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 최신 버전의 Google Cloud CLI가 설치되어 있는지 확인합니다.

    gcloud components update

  3. 프로젝트 ID를 찾습니다.

  4. 프로젝트를 명령어의 기본 프로젝트로 설정합니다.

    gcloud config set project PROJECT_ID

    PROJECT_ID를 프로젝트의 ID로 바꿉니다.

  5. App Hub API를 사용 설정합니다.

    gcloud services enable apphub.googleapis.com \
    --project PROJECT_ID

  6. 애플리케이션 관리 경계를 만들려면 프로젝트를 자체에 연결합니다.

    gcloud alpha apphub boundary update \
    --crm-node="projects/$(gcloud projects describe PROJECT_ID --format='value(projectNumber)')" \
    --project=PROJECT_ID \
    --location=global

    이 명령어는 프로젝트를 자체 관리 프로젝트로 구성하여 App Hub에서 프로젝트 내의 모든 지원되는 리소스를 자동으로 검색할 수 있도록 합니다.

  7. 첨부파일 상태를 확인합니다.

    gcloud alpha apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

    다음 예와 비슷한 출력이 표시됩니다.

    name: projects/PROJECT_ID/locations/LOCATION/boundary
crmNode: projects/PROJECT_NUMBER
createTime: 2025-08-28T19:04:47Z
updateTime: 2025-08-28T19:04:47Z
type: AUTOMATIC

    PROJECT_NUMBER는 프로젝트 ID에 해당하는 프로젝트 번호입니다.

    8. 관리 프로젝트 구성을 완료하면 애플리케이션 관리에 필요한 API가 사용 설정되며 App Hub를 사용하여 애플리케이션의 서비스와 워크로드를 그룹화할 수 있습니다. 선택적으로 권장 API를 검토하여 고급 기능에 액세스합니다.

    앱 허브 역할 및 권한 할당

    사용자가 App Hub를 사용하여 이 프로젝트 내에서 애플리케이션 구성요소를 검색, 등록, 관리하도록 하려면 적절한 App Hub 역할 및 권한을 부여해야 합니다.

    다음 단계를 따르세요.

    콘솔

    1. Google Cloud 콘솔에서 프로젝트 선택 도구를 사용하여 관리 프로젝트를 선택합니다.

    2. IAM 페이지로 이동합니다.

      IAM으로 이동

    3. 액세스 권한 부여를 클릭합니다. 액세스 권한 부여 창이 열립니다.

    4. 새 주 구성원 필드에 App Hub에 대한 액세스 권한을 부여할 주 구성원의 이메일 주소를 입력합니다.

    5. 역할 선택을 클릭하고 필터 필드에 App Hub를 입력합니다.

    6. 주 구성원에 할당할 App Hub IAM 역할을 선택하고 저장을 클릭합니다.

    gcloud

    1. 관리 프로젝트의 주 구성원에 대한 액세스 권한을 부여합니다.

      gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='user:EMAIL_ADDRESS' \
    --role='ROLE_NAME'

      다음을 바꿉니다.

      • PROJECT_ID: 관리 프로젝트의 ID입니다.
      • EMAIL_ADDRESS: App Hub 액세스 권한을 획득해야 하는 주 구성원의 이메일 주소입니다. 이 값은 username@yourdomain 형식이어야 합니다(예: my.user@example.com).
      • ROLE_NAME: 주 구성원에 할당할 App Hub IAM 역할입니다(예: roles/apphub.admin).

    애플리케이션 관리 경계 변경

    단일 프로젝트 경계를 정의하는 프로젝트를 변경하려면 이전 프로젝트에서 애플리케이션 관리를 사용 중지하고 새 프로젝트에서 사용 설정하세요. 애플리케이션 데이터는 이전되지 않으며 새 프로젝트에서 애플리케이션을 다시 만들어야 합니다.

    단일 프로젝트 경계에서 폴더 수준 경계로 이동하려면 앱 지원 폴더를 설정하세요. 이 작업은 폴더에 새 관리 프로젝트를 구성합니다. 이 새 관리 프로젝트에서 애플리케이션을 다시 만들어야 합니다.

    프로젝트에서 애플리케이션 관리 사용 중지

    App Hub 애플리케이션에서 더 이상 프로젝트의 리소스를 관리하지 않으려면 프로젝트에서 애플리케이션 관리를 사용 중지하면 됩니다.

    프로젝트에서 애플리케이션 관리를 사용 중지하면 프로젝트가 애플리케이션 관리 경계에서 분리됩니다. 애플리케이션의 서비스 및 워크로드는 계속 존재하지만 등록 상태가 분리로 변경됩니다. 프로젝트에서 애플리케이션 관리를 다시 사용 설정하면 기본 리소스가 아직 있는 경우 App Hub에서 애플리케이션, 서비스, 워크로드를 다시 검색하고 등록 상태를 업데이트할 수 있습니다.

    단일 프로젝트에서 애플리케이션 관리를 사용 중지하려면 다음 단계를 따르세요.

    1. In the Google Cloud console, activate Cloud Shell.

      Activate Cloud Shell

      At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

    2. 최신 버전의 Google Cloud CLI가 설치되어 있는지 확인합니다.

      gcloud components update

    3. 프로젝트 ID를 찾습니다.

    4. 프로젝트를 명령어의 기본 프로젝트로 설정합니다.

      gcloud config set project PROJECT_ID

      PROJECT_ID를 프로젝트의 ID로 바꿉니다.

    5. 애플리케이션 관리를 사용 중지하려면 경계에서 프로젝트를 분리하세요.

      gcloud alpha apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --clear-crm-node

      이 명령어는 경계 리소스를 업데이트하고 첨부파일을 삭제하여 프로젝트의 애플리케이션 관리를 사용 중지합니다.

    6. 경계를 설명하여 분리를 확인합니다.

      gcloud alpha apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

      출력에 crmNode 필드가 포함되지 않아 프로젝트에서 애플리케이션 관리가 사용 중지되었음을 확인할 수 있습니다.

    7. 선택적으로 프로젝트의 모든 애플리케이션을 삭제한 다음 이 프로젝트에서 더 이상 애플리케이션 기능을 사용하지 않을 경우 App Hub API를 사용 중지합니다.

      gcloud services disable apphub.googleapis.com \
    --project=PROJECT_ID

      8. 다음 단계