JupyterLab에서 Cloud Storage 버킷 및 파일 액세스

JupyterLab에서 Cloud Storage 버킷 및 파일 액세스

이 페이지에서는 Cloud Storage에 저장된 파일을 둘러볼 수 있도록 Cloud Storage 버킷을 Vertex AI Workbench 인스턴스의 JupyterLab 인터페이스에 마운트하는 방법을 보여줍니다. 텍스트 파일 및 노트북(IPYNB) 파일과 같은 JupyterLab과 호환되는 파일을 열고 수정할 수도 있습니다.

개요

Vertex AI Workbench 인스턴스에는 Cloud Storage 버킷을 마운트할 수 있게 해주는 Cloud Storage 통합이 포함되어 있습니다. 즉, 버킷의 콘텐츠를 둘러보고 JupyterLab 인터페이스 내에서 호환되는 파일로 작업할 수 있습니다.

Vertex AI Workbench 인스턴스와 동일한 프로젝트 내에서 인스턴스가 액세스할 수 있는 모든 Cloud Storage 버킷과 파일에 액세스할 수 있습니다.

참고: Cloud Storage에 대한 Vertex AI Workbench 인스턴스 액세스는 인스턴스에 액세스를 부여하는 데 사용한 단일 사용자 또는 서비스 계정에 따라 결정됩니다. 예를 들어 인스턴스에 특정 서비스 계정 액세스를 부여했으면 해당 서비스 계정에도 JupyterLab에서 사용하려는 Cloud Storage 버킷에 대한 액세스를 부여해야 합니다.

시작하기 전에

1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

4. Enable the Notebooks API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

7. Enable the Notebooks API.

   Enable the API

필요한 역할

사용자 계정에 Cloud Storage 버킷을 Vertex AI Workbench 인스턴스에 마운트하는 데 필요한 권한이 있는지 확인하려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 사용자 계정에 부여해 달라고 요청하세요.

• 노트북 실행자(roles/notebooks.runner)
• 스토리지 객체 사용자(roles/storage.objectUser)

역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

관리자는 커스텀 역할이나 다른 사전 정의된 역할을 통해 사용자 계정에 필요한 권한을 부여할 수도 있습니다.

공유 스토리지 마운트를 사용 설정하는 데 필요한 권한

Vertex AI Workbench 인스턴스에서 공유 스토리지 마운트를 사용 설정하려면 관리자에게 Vertex AI Workbench 인스턴스의 서비스 계정에 프로젝트에 대한 storage.buckets.list 권한을 부여해 달라고 요청하세요.

Vertex AI Workbench 인스턴스의 JupyterLab 인터페이스에 공유 스토리지 마운트 버튼을 표시하려면 storage.buckets.list 권한이 필요합니다.

버킷 및 Vertex AI Workbench 인스턴스 만들기

Vertex AI Workbench 인스턴스와 동일한 프로젝트에서 Cloud Storage 버킷 최소 하나 이상에 액세스할 수 있는 권한이 있어야 합니다.

1. Cloud Storage 버킷을 만들어야 하는 경우 버킷 만들기를 참조하세요.

2. Cloud Storage 버킷과 동일한 프로젝트에 아직 Vertex AI Workbench 인스턴스를 만들지 않았으면 인스턴스를 만듭니다.

JupyterLab 열기

1. Google Cloud 콘솔에서 인스턴스 페이지로 이동합니다.

   인스턴스로 이동

2. Vertex AI Workbench 인스턴스 이름 옆에 있는 JupyterLab 열기를 클릭합니다.

   Vertex AI Workbench 인스턴스가 JupyterLab을 엽니다.

Cloud Storage 버킷 마운트

Cloud Storage 버킷을 마운트하고 액세스하려면 다음을 수행합니다.

1. JupyterLab에서  파일 브라우저 탭이 선택되어 있는지 확인합니다.

2. 왼쪽 사이드바에서  공유 저장소 마운트 버튼을 클릭합니다. 버튼이 보이지 않으면 사이드바 오른쪽을 드래그하여 버튼이 표시될 때까지 사이드바를 확장합니다.

   

3. 버킷 이름 필드에 마운트하려는 Cloud Storage 버킷 이름을 입력합니다.

4. 마운트를 클릭합니다.

5. Cloud Storage 버킷은 왼쪽 사이드바의 파일 브라우저 탭에 폴더로 표시됩니다. 폴더를 더블클릭하여 열고 콘텐츠를 찾아봅니다.

문제 해결

Cloud Storage 버킷을 인스턴스에 마운트할 때 발생하는 문제를 진단하고 해결하는 방법은 Vertex AI Workbench 문제 해결을 참조하세요.

다음 단계

• Cloud Storage에 대해 자세히 알아봅니다.

• JupyterLab 내에서 BigQuery의 데이터를 쿼리하는 방법 알아보기