Oras

아티팩트 복사 및 푸시

oras cp 및 oras push 명령을 통해 OCI 레지스트리 간에 아티팩트를 복사하거나 로컬에서 레지스트리로 푸시할 수 있습니다. –force 옵션을 사용하면 부분적으로 채워진 대상에도 강제로 복사를 수행할 수 있습니다.

인증 컨텍스트 재사용

한 번 인증한 후에는 후속 호출에서 인증 컨텍스트를 재사용하여 효율적인 인증 처리가 가능합니다. 이는 특히 자동화 환경에서 인증 오버헤드를 줄이는 데 유용합니다.

백업 및 복원

oras backup 명령으로 원격 레지스트리의 아티팩트를 로컬 OCI 이미지 레이아웃(디렉터리 또는 tar 아카이브)으로 백업할 수 있습니다. 또는as restore 명령으로 백업된 아티팩트를 다시 원격 레지스트리로 복원할 수 있습니다.

레지스트리 및 태그 관리

oras repo ls 및 oras repo tags 명령을 통해 레지스트리 목록과 특정 저장소의 태그를 조회할 수 있습니다. –format 플래그를 사용하면 text, json, go-template 형식으로 출력을 맞춤 설정할 수 있습니다.

매니페스트 인덱스 관리

oras manifest index create 및 oras manifest index update 명령을 통해 OCI 이미지 인덱스를 생성하고 업데이트할 수 있으며, –artifact-type 플래그로 아티팩트 유형을 지정할 수 있습니다.

다운로드 및 설치 방법

Windows 사용자는 공식 GitHub 릴리스 페이지에서 제공하는 zip 아카이브를 다운로드하여 설치할 수 있습니다. 다운로드 후 압축을 풀고 oras 실행 파일을 원하는 위치에 배치한 후, 시스템 PATH에 해당 디렉터리를 추가하면 명령 프롬프트에서 oras 명령을 바로 사용할 수 있습니다.

또한 Scoop 패키지 관리자를 통해 다음 명령으로 설치할 수 있습니다:

scoop install oras

GitHub Actions 워크플로에서는 setup-oras 액션을 사용하여 간단히 설치 및 사용할 수 있습니다:

steps:
– uses: oras-project/setup-oras@v1
– run: oras version

특정 버전을 설치하려면 version 입력 없이 v prefix를 지정하지 않고 입력하면 됩니다. 예를 들어 v1.0.0을 설치하려면 version: ‘1.0.0’을 지정합니다.

기본 사용법

설치 후 명령 프롬프트에서 oras version을 실행하면 설치된 버전을 확인할 수 있습니다. 도움말은 oras –help 또는 특정 명령에 대해 oras –help를 실행하면 확인할 수 있습니다.

예를 들어, OCI 레지스트리에서 이미지를 pull하려면 다음 명령을 사용합니다:

oras pull ghcr.io/username/repository:tag -o ./local-path

로컬 디렉터리의 콘텐츠를 레지스트리로 push하려면:

oras push ghcr.io/username/repository:tag ./local-path

인증이 필요한 레지스트리의 경우 –username 및 –password 옵션을 사용하거나, 환경 변수를 통해 자격 증명을 제공할 수 있습니다.

지원 환경 및 시스템 요구사항

Oras는 Windows x64 아키텍처를 지원하며, zip 형식의 배포 파일을 제공합니다. 별도의 런타임 의존성이 없으며, 실행 파일 하나만으로 작동합니다. GitHub Actions, Azure Pipelines 등 CI/CD 환경에서 기본적으로 제공되는 러너 이미지에서도 사용할 수 있으나, 해당 이미지에 포함된 버전은 최신이 아닐 수 있으므로 명시적으로 설치하는 것이 권장됩니다.

최신 버전 및 업데이트

현재 버전은 1.3.4이며, GitHub 저장소의 릴리스 페이지에서 최신 버전 및 업데이트 내역을 확인할 수 있습니다. 정기적으로 기능 개선, 버그 수정, 보안 향상이 이루어지고 있습니다.