런타임 템플릿 관리

이 페이지에서는 다음 작업을 포함하여 Colab Enterprise 런타임 템플릿을 관리하는 방법을 설명합니다.

  • 런타임 템플릿 수정
  • 런타임 템플릿 삭제

필요한 역할

Colab Enterprise 런타임 템플릿을 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한Colab Enterprise 관리자 (roles/aiplatform.colabEnterpriseAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

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

런타임 템플릿 수정

Python 버전 및 암호화 키 구성을 비롯한 런타임 템플릿의 일부 사양을 변경할 수 있습니다. 런타임 템플릿을 변경하면 이 템플릿에서 새로 만든 런타임에만 적용됩니다.

런타임 템플릿을 수정하려면 Google Cloud 콘솔 또는 REST API를 사용하면 됩니다.

콘솔

런타임 템플릿을 수정하려면 다음 단계를 따르세요.

  1. 콘솔에서 Colab Enterprise 런타임 템플릿 페이지로 이동합니다. Google Cloud

    런타임 템플릿으로 이동

  2. 리전 메뉴에서 런타임 템플릿이 포함된 리전을 선택합니다.

  3. ID 열에서 수정할 런타임 템플릿 의 ID 번호를 클릭합니다.

  4.  수정을 클릭합니다.

  5. 런타임 템플릿 수정 패널에서 런타임 템플릿을 변경합니다.

  6. 업데이트 를 클릭합니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • REGION: 런타임 템플릿이 있는 리전입니다.
  • PROJECT_ID: 프로젝트 ID입니다.
  • NOTEBOOK_RUNTIME_TEMPLATE_ID: 런타임 템플릿의 ID입니다.
  • RELEASE_NAME: 사용할 이미지의 출시 이름입니다. 예를 들어 py311은 Python 3.11 이미지의 출시 이름입니다. 이미지를 Latest로 설정하려면 RELEASE_NAME을 비워 둡니다.

HTTP 메서드 및 URL: 

PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name

JSON 요청 본문: 

{
  softwareConfig: {
    colabImage: {
      releaseName: "RELEASE_NAME"
    }
  }
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다. 

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다. 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | Select-Object -Expand Content
요청이 성공하면 응답 본문에 Operation의 인스턴스가 포함됩니다.

사용 가능한 쿼리 매개변수에 대한 자세한 내용은 notebookRuntimeTemplates.patch REST API 문서를 참조하세요.

런타임 템플릿 삭제

런타임 템플릿을 삭제하려면 Google Cloud 콘솔, gcloud CLI 또는 REST API를 사용하면 됩니다.

콘솔

런타임 템플릿을 삭제하려면 다음 단계를 따르세요.

  1. 콘솔에서 Colab Enterprise 런타임 템플릿 페이지로 이동합니다. Google Cloud

    런타임 템플릿으로 이동

  2. 리전 메뉴에서 런타임 템플릿이 포함된 리전을 선택합니다.

  3. 삭제할 런타임 템플릿을 선택합니다.

  4. 삭제 삭제 를 클릭합니다.

  5. 확인을 클릭합니다.

gcloud

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

  • RUNTIME_ID: 런타임의 ID
  • PROJECT_ID: 프로젝트 ID
  • REGION: 런타임이 있는 리전

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows(PowerShell)

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows(cmd.exe)

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

명령줄에서 런타임 템플릿을 삭제하는 명령어에 대한 자세한 내용은 gcloud CLI 문서를 참조하세요.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • REGION: 런타임이 있는 리전입니다.
  • PROJECT_ID: 프로젝트 ID입니다.
  • RUNTIME_ID: 런타임의 ID입니다.

HTTP 메서드 및 URL: 

DELETE https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다. 

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID"

PowerShell

다음 명령어를 실행합니다. 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID" | Select-Object -Expand Content
요청이 성공하면 응답 본문에 Operation의 인스턴스가 포함됩니다.

자세한 내용은 notebookRuntimeTemplates.delete REST API 문서를 참조하세요.

다음 단계