이미지 레지스트리 및 리포지토리 작업

Snowpark Container Services 는 OCIv2 호환 이미지 레지스트리 서비스와 이미지를 저장하기 위한 저장소 유닛 호출 리포지토리를 제공합니다. 다음 Snowflake CLI 명령을 사용하여 Snowpark Container Services 이미지 레지스트리 및 리포지토리를 관리할 수 있습니다.

Snowpark Container Services 이미지 레지스트리 및 리포지토리에 대한 자세한 내용은 Snowpark Container Services: 이미지 레지스트리 및 리포지토리 작업하기 섹션을 참조하십시오.

이미지 레지스트리 관리

Snowflake CLI 를 사용하면 Snowpark Container Services 이미지 리포지토리로 다음 작업을 수행할 수 있습니다.

나열 또는 삭제와 같은 일반적인 작업의 경우 Snowflake 오브젝트 관리하기 의 설명과 같이 Snowflake CLI 는 snow object 명령을 사용합니다.

레지스트리 인증을 위한 환경 토큰 가져오기

snow spcs image-registry token 명령을 사용하여 레지스트리 인증에 사용할 수 있는 지정된 연결과 연결된 토큰을 반환할 수 있습니다.

snow spcs image-registry token --connection mytest

+----------------------------------------------------------------------------------------------------------------------+
| key        | value                                                                                                   |
|------------+---------------------------------------------------------------------------------------------------------|
| token      | ****************************************************************************************************    |
|            | ****************************************************************************************************    |
| expires_in | 3600                                                                                                    |
+----------------------------------------------------------------------------------------------------------------------+

그런 다음 해당 토큰을 다음과 같이 docker login 명령에 파이프로 연결하여 Docker 컨테이너에 로그인하는 데 사용할 수 있습니다.

snow spcs image-registry token --format=JSON | docker login <org>-<account>.registry.snowflakecomputing.com -u 0sessiontoken --password-stdin

이미지 레지스트리에 로그인

snow spcs image-registry login 은 연결에 지정된 자격 증명을 사용하여 이미지 리포지토리에 로그인합니다. 로그인하기 전에 다음 전제 조건을 충족해야 합니다.

  • 이 명령은 Docker를 사용하여 Snowflake에 로그인하기 때문에 Docker Desktop 이 설치되어 있어야 합니다.

  • 레지스트리 URL을 가져오려면 현재 역할에 계정의 이미지 리포지토리에 대한 READ 권한이 있어야 합니다.

계정 자격 증명으로 이미지 레지스트리에 로그인하려면 다음을 사용하십시오.

snow spcs image-registry login

Login Succeeded

이미지 레지스트리에 대한 URL 검색

snow spcs image-registry url 명령은 이미지 리포지토리에 대한 URL을 반환합니다. 레지스트리 URL을 가져오려면 현재 역할에 계정의 이미지 리포지토리에 대한 READ 권한이 있어야 합니다.

리포지토리에 대한 URL을 가져오려면 다음을 수행합니다.

snow spcs image-registry url

<orgname-acctname>.registry.snowflakecomputing.com

이미지 리포지토리 관리

Snowflake CLI 를 사용하면 Snowpark Container Services 이미지 리포지토리로 다음 작업을 수행할 수 있습니다.

나열 또는 삭제와 같은 일반적인 작업의 경우 Snowflake 오브젝트 관리하기 의 설명과 같이 Snowflake CLI 는 snow object 명령을 사용합니다.

이미지 리포지토리 만들기

snow spcs image-repository create 명령은 현재 스키마에 새 이미지 리포지토리를 만듭니다.

이미지 리포지토리를 만들려면 다음과 유사한 명령을 입력합니다.

snow spcs image-repository create tutorial_repository

+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+

프로젝트 정의에서 이미지 리포지토리 생성 및 배포하기

snowflake.yml 프로젝트 정의 파일을 생성하고 snow spcs image-repository deploy 명령을 실행하여 이미지 리포지토리를 스테이지에 배포할 수 있습니다.

snowflake.yml 프로젝트 정의 파일 샘플은 다음과 같습니다.

definition_version: 2
entities:
  my_image_repository:
    type: image-repository
    identifier: my_image_repository

다음 표에서는 컴퓨팅 풀 프로젝트 정의의 속성에 대해 설명합니다.

이미지 리포지토리 프로젝트 정의 속성

속성

정의

유형

필수, 문자열

image-repository 여야 합니다.

식별자

선택 사항, 문자열

엔터티의 Snowflake 식별자입니다. 값은 다음 형식일 수 있습니다.

  • 문자열 식별자 텍스트

    identifier: my-image-repository

    따옴표로 묶지 않은 식별자와 따옴표로 묶은 식별자가 모두 지원됩니다. 따옴표로 묶은 식별자를 사용하려면 YAML 값에 따옴표를 포함하십시오(예: "My Image Repository").

  • 오브젝트

    identifier:
  name: my-image-repository
  schema: my-schema # optional
  database: my-db # optional

    참고

    schema 또는 database 를 지정하고 name 속성에 정규화된 이름(예: mydb.schema1.my-app)을 사용하면 오류가 발생합니다.

이미지 리포지토리를 만들고 배포하려면 다음을 수행하십시오.

  1. 현재 디렉터리를 프로젝트 정의 파일이 포함된 디렉터리로 변경합니다.

  2. 다음과 유사하게 snow spcs image-repository deploy 명령을 실행합니다.

    snow spcs image-repository deploy

    +---------------------------------------------------------------------+
| key    | value                                                      |
|--------+------------------------------------------------------------|
| status | Image Repository MY_IMAGE_REPOSITORY successfully created. |
+---------------------------------------------------------------------+

이미지 리포지토리에 대한 URL 검색

snow spcs image-repository url 명령은 이미지 리포지토리에 대한 URL을 가져옵니다.

URL을 가져오려면 다음과 유사한 명령을 입력합니다.

snow spcs image-repository url tutorial_repository

<orgname-acctname>.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository

이미지 리포지토리에 태그와 이미지 나열

snow spcs image-repository list-images 명령어를 사용하면 이미지 리포지토리의 이미지와 태그를 가져올 수 있습니다.

리포지토리에 있는 이미지와 태그를 나열하려면 다음과 유사한 명령을 입력합니다. 그러면 my_db 데이터베이스의 images 리포지토리에 있는 이미지가 나열됩니다.

snow spcs image-repository list-images images --database my_db

+----------------------------+---------------+---------+-------------------------------------------------+-----------------------------------------+
| created_on                 | image_name    | tags    | digest                                          | image_path                              |
|----------------------------+---------------+---------+-------------------------------------------------+-----------------------------------------|
| 2024-10-11 14:23:49-07:00  | echo_service  | latest  | sha256:a8a001fef406fdb3125ce8e8bf9970c35af7084  | my_db/test_schema/images/echo_service:  |
|                            |               |         | fc33b0886d7a8915d3082c781                       | latest                                  |
| 2024-10-14 22:21:14-07:00  | test_counter  | latest  | sha256:8cae96dac29a4a05f54bb5520003f964baf67fc  | my_db/test_schema/images/test_counter:  |
|                            |               |         | 38dcad3d2c85d6c5aa7381174                       | latest                                  |
+----------------------------+---------------+---------+-------------------------------------------------+-----------------------------------------+