플러그인 관리

이 페이지에서는 서비스 확장 프로그램을 사용하여 생성된 플러그인을 보고, 수정하고, 삭제하는 방법을 설명합니다.

플러그인 기능은 Media CDN의 미리보기 버전으로 제공됩니다.

제품 개요는 서비스 확장 프로그램 개요를 참고하세요.

플러그인 보기

이 섹션에서는 서비스 확장 프로그램을 사용하여 생성된 플러그인과 플러그인 버전을 보는 방법을 설명합니다.

플러그인 나열

프로젝트의 플러그인을 나열하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 서비스 확장 프로그램 페이지로 이동합니다.

   서비스 확장 프로그램으로 이동

2. 플러그인 탭을 클릭합니다.

   다음 정보와 함께 정렬 가능한 표에 플러그인 목록이 표시됩니다.

   • 상태: 플러그인의 상태입니다. 서비스가 연결되지 않은 경우 값은 Not attached입니다. 서비스가 플러그인과 함께 연결된 경우 값은 Attached입니다.
   • 이름: 플러그인의 이름입니다.
   • 기본 버전: 활성 상태인 플러그인 버전입니다.
   • 제품: 플러그인이 연결된 Google Cloud 제품입니다.
   • 유형: 확장 프로그램 유형입니다.
   • 범위: 플러그인의 범위입니다.
   • 리전: 플러그인 범위가 Regional인 경우의 리전입니다.
   • 사용 중인 확장 프로그램: 플러그인이 연결된 하나 이상의 확장 프로그램입니다.
   • 최종 수정 시간: 플러그인이 마지막으로 수정된 시간입니다.
   • 라벨: 플러그인에 추가된 라벨입니다.

3. 선택사항: 목록을 필터링하려면 다음 단계를 따르세요.

   1. 테이블 필터링 옆에 있는 아이콘을 클릭하여 속성 목록을 확인합니다.

   2. 목록에서 속성을 선택합니다.

      필터 테이블 라벨 옆에 콜론과 함께 속성 이름이 표시됩니다.

   3. 콜론 옆에 공백을 삽입하여 속성과 일치하는 값 목록을 확인한 후 목록에서 값을 선택합니다.

   4. 선택사항: 속성-값 쌍 사이에 OR 연산자를 입력하여 조합된 필터를 지정합니다.

4. 선택사항: 선택한 플러그인으로 다른 작업을 수행하려면 추가 작업을 클릭한 다음 옵션을 선택합니다.

   • 플러그인을 수정하려면 수정을 클릭합니다.
   • 플러그인을 삭제하려면 삭제를 클릭합니다.
   • 로그 탐색기를 열어 플러그인에 관한 로그 데이터를 검색, 조회, 분석하려면 로그 탐색기에서 보기를 클릭합니다.
   • 서비스 확장 프로그램 모니터링 페이지를 열려면 모니터링 보기를 클릭합니다.

gcloud

gcloud service-extensions wasm-plugins list 명령어를 실행합니다.

gcloud service-extensions wasm-plugins list \
    --location=LOCATION

LOCATION을 플러그인의 위치(global 또는 리전)로 바꿉니다.

프로젝트의 플러그인은 다음 정보가 포함된 표에 나열됩니다.

• 이름: 플러그인의 이름
• 설명: 플러그인에 대한 설명
• 기본 버전: 활성 플러그인 버전
• 업데이트 시간: 플러그인이 마지막으로 수정된 시간

플러그인 세부정보 보기

플러그인의 세부정보를 보려면 다음 방법 중 하나를 사용하세요.

콘솔

1. Google Cloud 콘솔에서 서비스 확장 프로그램 페이지로 이동합니다.

   서비스 확장 프로그램으로 이동

2. 플러그인 탭을 클릭합니다.

3. 세부정보를 보려는 플러그인의 이름을 클릭합니다.

   플러그인의 세부정보 페이지가 열립니다. 이 페이지에는 다음 섹션이 있습니다.

   • 기본 정보: 이 섹션에는 플러그인이 연결된 Google Cloud 제품, 부하 분산기 유형, 확장 프로그램 유형, 플러그인을 사용하는 확장 프로그램, 플러그인 범위, 플러그인의 생성 및 수정 타임스탬프, 플러그인 크기, 라벨, 로깅이 사용 설정된 경우 로그 샘플링 비율 및 최소 로깅 수준 등 플러그인에 관한 기본 세부정보가 표시됩니다.

   • 버전: 이 섹션에는 플러그인 버전, 생성 타임스탬프, 지정된 설명, 이미지의 URI 및 다이제스트, 플러그인 구성 파일 또는 이미지 및 관련 다이제스트를 비롯한 플러그인 버전에 관한 세부정보가 표시됩니다.

     이미지 URL을 클릭하여 세부정보를 볼 수 있습니다.

gcloud

플러그인의 세부정보를 보려면 gcloud service-extensions wasm-plugins describe 명령어를 실행합니다.

 gcloud service-extensions wasm-plugins describe WASM_PLUGIN \
     --location=LOCATION

다음을 바꿉니다.

• WASM_PLUGIN: 플러그인 이름
• LOCATION: 플러그인의 위치(global 또는 리전)

플러그인에 관한 다음 세부정보가 표시됩니다.

• 플러그인 이름
• 플러그인의 생성 및 수정 타임스탬프
• 라벨
• 로그 샘플링 레이트 (로깅이 사용 설정된 경우)

플러그인의 버전을 나열하려면 gcloud service-extensions wasm-plugin-versions list 명령어를 사용합니다.

 gcloud service-extensions wasm-plugin-versions list WASM_PLUGIN \
     --location=LOCATION

다음을 바꿉니다.

• WASM_PLUGIN: 플러그인 이름
• LOCATION: 플러그인의 위치(global 또는 리전)

지정된 플러그인의 버전이 플러그인 이름과 함께 표에 나열됩니다.

플러그인 버전의 세부정보를 보려면 gcloud service-extensions wasm-plugin-versions describe 명령어를 사용합니다.

 gcloud service-extensions wasm-plugin-versions describe WASM_PLUGIN_VERSION \
     --location=LOCATION

다음을 바꿉니다.

• WASM_PLUGIN_VERSION: 플러그인의 기본 버전
• LOCATION: 플러그인의 위치(global 또는 리전)

플러그인 버전에 관한 다음 세부정보가 표시됩니다.

• 버전 이름
• 생성 타임스탬프
• 설명(입력된 경우)
• 이미지의 URI 및 다이제스트
• 플러그인 구성 파일 또는 이미지 및 관련 다이제스트

플러그인 수정

이 섹션에서는 서비스 확장 프로그램을 사용하여 만든 플러그인을 수정하는 방법을 설명합니다.

플러그인 수정

플러그인을 수정하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 서비스 확장 프로그램 페이지로 이동합니다.

   서비스 확장 프로그램으로 이동

2. 플러그인 탭을 클릭합니다.

3. 수정하려는 플러그인의 경우 작업 더보기를 클릭한 다음 수정을 선택합니다.

   또는 플러그인 이름을 클릭한 다음 세부정보 페이지에서 수정을 클릭합니다.

   플러그인 수정 페이지에서는 플러그인 이름을 수정할 수 없습니다. 다른 세부정보는 수정할 수 있습니다.

4. 필요에 따라 항목을 변경합니다.

   대부분의 필드에 관한 자세한 내용은 플러그인 만들기를 참고하세요.

   버전 섹션에 대한 자세한 내용은 플러그인의 새 버전 추가를 참고하세요.

5. 플러그인 업데이트를 클릭합니다.

gcloud

gcloud service-extensions wasm-plugins update 명령어를 실행합니다.

gcloud service-extensions wasm-plugins update WASM_PLUGIN \
   --location=LOCATION \
   --description=PLUGIN_DESCRIPTION \
   --labels=[LABELS,...]

다음을 바꿉니다.

• WASM_PLUGIN: 플러그인 이름
• LOCATION: 플러그인의 위치(global 또는 리전)
• PLUGIN_DESCRIPTION: 플러그인에 대한 설명
• LABELS: 쉼표로 구분된 키-값 쌍 형식의 라벨

플러그인의 새 버전 추가

플러그인 코드의 새 버전을 만든 다음 플러그인의 새 버전으로 추가할 수 있습니다.

플러그인의 새 버전을 추가하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 서비스 확장 프로그램 페이지로 이동합니다.

   서비스 확장 프로그램으로 이동

2. 플러그인 탭을 클릭합니다.

3. 수정을 클릭합니다.

4. 버전 섹션에서 버전 추가를 클릭합니다.

5. 버전 추가 창에서 플러그인 버전의 세부정보를 지정합니다.

6. 선택사항: 기본으로 설정 체크박스를 선택합니다.

   나중에 이 버전을 기본 버전으로 설정할 수도 있습니다.

7. 추가를 클릭합니다.

8. 플러그인 업데이트를 클릭합니다.

gcloud

gcloud service-extensions wasm-plugins update 명령어를 실행합니다.

 gcloud service-extensions wasm-plugins update WASM_PLUGIN \
     --location=LOCATION \
     --image=IMAGE \
     --main-version=MAIN_VERSION \
     --plugin-config=PLUGIN_CONFIG | --plugin-config-file=PLUGIN_CONFIG_FILE | --plugin-config-uri=PLUGIN_CONFIG_URI

다음을 바꿉니다.

• WASM_PLUGIN: 플러그인의 ID 또는 정규화된 이름
• LOCATION: 플러그인의 위치(global 또는 리전)
• IMAGE: Artifact Registry 저장소에 저장된 새 Wasm 모듈의 URI
• MAIN_VERSION: 생성하고 기본 (또는 제공) 버전으로 설정할 플러그인 버전의 ID입니다.
• PLUGIN_CONFIG, PLUGIN_CONFIG_FILE 또는 PLUGIN_CONFIG_URI: 선택적 구성 파일로, 각각 텍스트, 로컬 파일 또는 Artifact Registry의 이미지로 인라인으로 지정할 수 있습니다.

참고: 새 플러그인 버전을 만들면서 기본 버전으로 설정하지 않으려면 gcloud service-extensions wasm-plugins create 명령어를 사용하세요.

플러그인의 기본 버전 변경

플러그인의 기본 버전을 변경하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 서비스 확장 프로그램 페이지로 이동합니다.

   서비스 확장 프로그램으로 이동

2. 플러그인 탭을 클릭합니다.

3. Edit(수정) 버튼을 클릭합니다.

4. 버전 섹션에서 비활성 버전을 선택한 다음 기본값으로 설정을 클릭합니다.

   또는 플러그인의 새 버전을 만드는 동안 버전을 기본 버전으로 설정할 수 있습니다.

5. 플러그인 업데이트를 클릭합니다.

gcloud

gcloud service-extensions wasm-plugins update 명령어를 실행합니다.

 gcloud service-extensions wasm-plugins update \
     --location=LOCATION \
     --main-version=WASM_PLUGIN_VERSION

다음을 바꿉니다.

• LOCATION: 플러그인의 위치(global 또는 리전)
• WASM_PLUGIN_VERSION: 플러그인의 기본 버전 이름

새 플러그인 버전이 모든 위치에 배포되는 데 몇 분 정도 걸릴 수 있습니다. 플러그인이 모든 위치에 동시에 제공되지 않으므로 위치에 따라 분 수가 다를 수 있습니다.

참고: 플러그인을 롤백하려면 이전 버전을 기본 버전으로 설정하세요.

플러그인 삭제

이 섹션에서는 서비스 확장 프로그램을 사용하여 생성된 플러그인과 플러그인 버전을 삭제하는 방법을 설명합니다.

플러그인 삭제

플러그인을 삭제하려면 다음 단계를 따르세요.

콘솔

1. 서비스 확장 프로그램 페이지로 이동합니다.

   서비스 확장 프로그램으로 이동

2. 플러그인 탭을 클릭합니다.

3. 삭제하려는 플러그인의 경우 추가 작업 버튼을 클릭한 다음 삭제를 선택합니다.

   또는 플러그인 이름을 클릭한 다음 세부정보 페이지에서 삭제 버튼을 클릭합니다.

   확장 프로그램에서 사용 중인 플러그인은 삭제할 수 없습니다. 이러한 플러그인을 삭제하려면 먼저 확장 프로그램을 수정하여 플러그인을 삭제하거나 확장 프로그램을 삭제합니다.

4. 확인 메시지 상자에서 삭제를 클릭하여 작업을 확인합니다.

gcloud

1. 서비스 구성에서 플러그인 참조를 삭제한 다음 구성 YAML 파일을 다시 가져옵니다.

   자세한 내용은 Cloud Load Balancing 경로 및 트래픽 플러그인과 Media CDN 플러그인을 구성하는 방법을 참고하세요.

2. gcloud service-extensions wasm-plugins delete 명령어를 실행합니다.

   gcloud service-extensions wasm-plugins delete WASM_PLUGIN \
       --location=LOCATION
   

   다음을 바꿉니다.

   • WASM_PLUGIN: 플러그인 이름
   • LOCATION: 플러그인의 위치(global 또는 리전)

플러그인을 삭제하면 관련 플러그인 리소스도 삭제됩니다.

플러그인 버전 삭제

플러그인 버전을 삭제하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 서비스 확장 프로그램 페이지로 이동합니다.

   서비스 확장 프로그램으로 이동

2. 플러그인 탭을 클릭합니다.

3. 수정할 플러그인을 선택하고 수정 모드로 전환합니다.

4. 버전 섹션에서 삭제할 버전의 체크박스를 선택한 다음 삭제를 클릭합니다.

5. 플러그인 업데이트를 클릭합니다.

gcloud

gcloud service-extensions wasm-plugin-versions delete 명령어를 실행합니다.

 gcloud service-extensions wasm-plugin-versions delete WASM_PLUGIN_VERSION \
     --location=LOCATION

다음을 바꿉니다.

• WASM_PLUGIN_VERSION: 기본 버전으로 사용되지 않는 플러그인 버전의 이름
• LOCATION: 플러그인의 위치(global 또는 리전)

버전이 기본 버전 (활성)으로 설정된 경우 다른 버전을 기본 버전으로 설정한 후에만 삭제할 수 있습니다.

다음 단계

• 플러그인을 만드는 방법을 알아보세요.
• 서비스 확장 프로그램 개요를 참고하세요.