GDC 콘솔에서 프로젝트 선택기를 사용하여 프로젝트 또는 조직을 선택하여 해당 상위 리소스 아래에 중첩된 서비스 리소스와 상호작용할 수 있습니다. 예를 들어 가상 머신 (VM)은 프로젝트 범위입니다.
하위 리소스의 컨텍스트가 변경되면 프로젝트 선택기가 최신 상위 리소스 유형 간에 자동으로 전환됩니다. 예를 들어 프로젝트 선택기에서 조직을 선택한 상태로 프로젝트 범위 리소스에 액세스하면 선택기에서 마지막으로 사용한 프로젝트를 자동으로 선택하여 리소스 범위를 원활하게 변경합니다. 마찬가지로 조직 범위 리소스에 액세스할 때 조직이 자동으로 선택됩니다.
상위 리소스에 중첩된 GDC 리소스와 상호작용하려면 먼저 작업할 조직 또는 프로젝트를 선택해야 합니다.
대시보드에서 프로젝트 선택 도구 드롭다운을 클릭합니다.
프로젝트 창이 나타나면 프로젝트 또는 조직을 선택합니다.
열기를 클릭합니다.
프로젝트 업데이트
프로젝트 이름, 데이터 유출 방지와 같이 생성 후 업데이트할 수 있는 프로젝트 구성이 있습니다. 프로젝트 사용량이 변경되면 이러한 구성을 업데이트할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eGoogle Distributed Cloud (GDC) projects are foundational for creating, enabling, and utilizing all GDC services, including managing APIs, collaborators, and permissions.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage GDC projects using the GDC console, \u003ccode\u003egdcloud\u003c/code\u003e CLI, and \u003ccode\u003ekubectl\u003c/code\u003e CLI, each providing different methods for viewing, updating, and interacting with project resources.\u003c/p\u003e\n"],["\u003cp\u003eAccess to projects and their resources is controlled by IAM roles, with Project Editor and Project Viewer roles determining whether a user can edit or only view project details.\u003c/p\u003e\n"],["\u003cp\u003eProjects allow for the segmentation of resources within an organization, and you can monitor these resources, as well as user and group access policies, to maintain boundaries between projects.\u003c/p\u003e\n"],["\u003cp\u003eThe GDC console features a project picker that allows users to seamlessly switch between different projects or organizations to manage the appropriate scoped resources, automatically transitioning based on resource context.\u003c/p\u003e\n"]]],[],null,["# Manage projects and their resources\n\nGoogle Distributed Cloud (GDC) air-gapped appliance projects form the basis for creating, enabling,\nand using all GDC services including managing APIs,\nadding and removing collaborators, and managing permissions for\nGDC resources.\n\nThis page explains how to manage GDC projects using the\nGDC console, gdcloud CLI, and `kubectl` CLI.\n\nBefore you begin\n----------------\n\nTo get the permissions needed to edit an existing project or view a project's\nresources, ask your Organization IAM Admin to grant you the Project Editor role\n(`project-editor`).\n\nTo get the permissions needed to only view a project's resources without the\nability to edit the project, ask your Organization IAM Admin to grant you the\nProject Viewer role (`project-viewer`).\n\nTo use the gdcloud CLI, ensure you have it installed. For more\ninformation, see the gdcloud CLI\n[Overview](/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-overview#download_and_install_the)\npage.\n\nView project details\n--------------------\n\nYou can view your project's metadata to review current configurations such as\nlabels and network settings. \n\n### Console\n\n1. Open the navigation menu and select **Projects**.\n\n2. Click the project you want to view details for:\n\n### gdcloud\n\nTo list the metadata for a specific project, run: \n\n gdcloud projects describe \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\nReplace \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e with the unique identifier for\nyour project.\n\nCheck project resources\n-----------------------\n\nYou can check project resources to monitor the segmentation of resources within\nan organization. You can also check user and group access policies, which you\ndefine per project to provide boundaries between projects.\n\n### List role bindings in a project\n\nTo list the role bindings in a project, run: \n\n kubectl get rolebindings -n \u003cvar translate=\"no\"\u003ePROJECT_NAMESPACE\u003c/var\u003e\n\nFor more information on role bindings, see\n[Grant access to resources](/distributed-cloud/hosted/docs/latest/appliance/platform/pa-user/iam/set-up-role-bindings).\n\nSelect a project or organization\n--------------------------------\n\nIn the GDC console, you can select a project or organization using the\nproject picker to interact with the service resources nested under that parent\nresource. For example, a virtual machine (VM) is project-scoped.\n\nThe project picker automatically transitions between the most recent parent\nresource types when the context of the child resource changes. For example, when\nyou access a project-scoped resource when you have an organization selected in\nthe project picker, the picker automatically selects the last used project to\nseamlessly change the resource scope. Likewise, the organization is autoselected\nwhen accessing organization-scoped resources.\n| **Note:** If you've never chosen a project from the project picker when accessing a project-scoped resource, you must manually select a project from the dialog.\n\nTo interact with GDC resources nested in a parent\nresource, you must first select the organization or project to work in:\n\n1. From the dashboard, click the project picker drop-down.\n\n2. In the **Projects** window that appears, select your project or organization.\n\n3. Click **Open**.\n\nUpdate a project\n----------------\n\nThere are a subset of configurations for your project that can be updated after\ncreation, such as project name and data exfiltration protection. You can\nupdate these configurations as your usage of the project evolves.\n\nFor example, you can edit the project's name by completing the following steps: \n\n### Console\n\n1. Open the navigation menu and select **Projects**.\n\n2. Click the project you want to edit.\n\n3. Click edit **Edit** next\n to the **Project display name** field.\n\n4. Provide the updated project name and click **Save**.\n\n### gdcloud\n\nRun the following command: \n\n gdcloud projects update \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e --name=\u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e\n\nReplace the following variables:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the unique identifier for your project.\n- \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e: the new name for the project.\n\nYou can replace the `--name` parameter with any editable project field. Run\n`gdcloud projects update --help` for more options.\n\nView projects in an organization\n--------------------------------\n\nAs an Administrator, you can only view and list projects you have access to with\nIAM roles. The Organization IAM Admin role can view and list all projects in\nthe organization. \n\n### Console\n\nTo view all projects in an organization, go to the console's navigation menu\nand select **Projects**.\n\n### gdcloud\n\nTo view all projects you have access to in an organization, run: \n\n gdcloud projects list\n\nYou cannot list projects you don't have permission to access."]]
