TOP GUN

Ed Sheeran - Even my dad does sometimes

SYPER — Wed, 26 Apr 2023 13:31:31 +0900

It's alright to cry
울어도 괜찮아요

Even my dad does sometimes
우리 아빠도 가끔 그러거든요.

So don't wipe your eyes
그러니 눈물을 닦지 말아요

Tears remind you you're alive
눈물은 당신이 살아있음을 알려줄테니

It's alright to die
죽는 건 괜찮아요

'Cause death's the only thing you haven't tried
죽음은 당신이 해보지 않은 유일한 것이니까요.

But just for tonight
하지만, 오늘밤만은

Hold on
멈춰요.

So live life like you're giving up
포기하려던 것처럼 그렇게 살아봐요

'Cause you act like you are
당신은 당신 자신처럼 행동하니까

Go ahead and just live it up
앞을 향해 나아가, 그저 살아가요

Go on and tear me apart
계속하면 내 맘을 아프게 할거에요

It's alright to shake
떨어도 괜찮아요

Even my hand does sometimes
내 손도 가끔 그러거든요.

So inside we'll rage
그래요, 우리는 마음속으로 분노하죠

Against the dying of the light
빛이 사라져 가는 것에 대해

It's alright to say
말해도 괜찮아요

That death's the only thing you haven't tried
죽음은 당신이 해보지 않은 유일한 것이니까요.

But just for today
Hold on
So live life like you're giving up
'Cause you act like you are
Go ahead and just live it up
Go on and tear me apart
And hold on
Live life like you're giving up
'Cause you act like you are
Go ahead and just live it up
Go on and tear me apart
And hold on

GETOPTS

SYPER — Mon, 17 Apr 2023 15:40:24 +0900

고급 쉘 스크립트에 필수적인 getopts 맨페이지

getopts optstring name [args]

getopts는 파라미터는 쉘 프로시저에서 위치 매개변수를 구문 분석하는 데 사용됩니다. optstring은 인식되는 옵션 문자를 포함합니다. 문자 뒤에 콜론이 오는 경우, 옵션은 공백으로 구분되는 인수가 있어야 합니다. 콜론 및 물음표 문자는 옵션 문자로 사용할 수 없습니다.

호출될 때마다, getopts는 쉘 변수 이름에 다음 옵션을 배치하고, 존재하지 않는 경우 name을 초기화하며, 다음 인수의 인덱스를 변수 OPTIND로 처리합니다. OPTIND는 쉘 또는 쉘 스크립트가 호출될 때마다 1로 초기화됩니다. 옵션에 인수가 필요한 경우 getopts는 해당 인수를 OPTARG 변수에 배치합니다. 쉘은 OPTIND를 자동으로 리셋하지 않습니다; 새 매개변수 세트를 사용하려면 동일한 쉘 호출 내에서 getopts에 대한 여러 호출 간에 수동으로 재설정해야 합니다.

옵션의 끝을 만나면 getopts는 0보다 큰 반환 값으로 종료됩니다. OPTIND는 옵션이 아닌 첫 번째 인수의 인덱스로 설정되고 이름은 ?로 설정됩니다.

getopts는 일반적으로 위치 매개변수를 구문 분석하지만 args에 더 많은 인수가 제공되면 getopts는 대신 해당 매개변수를 구문 분석합니다.

getopts는 두 가지 방법으로 오류를 보고할 수 있습니다. optstring의 첫 번째 문자가 콜론이면 자동 오류 보고가 사용됩니다. 정상적인 작동에서 유효하지 않은 옵션이나 누락된 옵션 인수가 발견되면 진단 메시지가 인쇄됩니다. OPTERR 변수가 0으로 설정되면 optstring의 첫 번째 문자가 콜론이 아닌 경우에도 오류 메시지가 표시되지 않습니다.

유효하지 않은 옵션이 표시되면 getopts는 ?를 이름에 입력하고, 자동이 아닌 경우, 오류 메시지를 인쇄하고 OPTARG를 upset합니다. getopts가 자동이면 찾은 옵션 문자가 OPTARG에 배치되고 진단 메시지가 인쇄되지 않습니다.

필요한 인수가 없고 getopts가 자동이 아닌 경우, 이름에 물음표(?)가 표시되고 OPTARG가 unset되며 진단 메시지가 인쇄됩니다. getopts가 자동이면, 콜론(:)이 이름에 배치되고 OPTARG는 발견된 옵션 문자로 설정됩니다.

지정되거나 지정되지 않은 옵션이 발견되면 getopts는 true를 반환합니다. 옵션의 끝을 만나거나 오류가 발생하면 false를 반환합니다.

고품질의 무료 PPT 템플릿 사이트 추천

SYPER — Fri, 16 Dec 2022 16:49:58 +0900

PPT 제작 자료를 찾기 위해 웹 서치 중에 찾은 아주 좋은 사이트가 있어서 공유할까 합니다.

우선 여타 무료인 것처럼 낚시하는 유료 PPT 사이트와는 다르고요.
개인적으로 주인 분이 운영하시는 것 같아요.
유료에 비해서도 뒤지지 않는 품질의 템플릿들이 올라옵니다.

자료가 아주 방대한 것은 아니지만, 꽤 많구요.

기본적으로 제공되는 포인트로 필요한 템플릿을 구매하실 수 있는데,
포인트는 댓글을 달아서 추가로 얻을 수도 있습니다.
물론 본인의 템플릿을 공유해서 포인트를 얻을 수도 있고요.
PPT 자료 제작하시는 분들에게 추천하는 사이트입니다.

주소 : https://freepik.kr

Windows 파일공유(SMB) 대체를 위한 SSHFS

SYPER — Thu, 26 Jul 2018 13:03:25 +0900

우리가 흔히 사용하는 Windows의 파일공유 서비스(SMB)는 유용하지만,

기본적으로 권한 이슈와 더불어, WIndows 파일공유 프로토콜 자체의 취약성으로 인해

일반적으로 랜섬웨어, 웜 바이러스등의 주요 공격 대상이 됩니다.

- Windows 파일공유(SMB) 서비스 포트

TCP : 139, 445

UDP : 138, 139

Windows 전문가가 아니라 정확하진 않지만, TCP 포트 관련해서는 139, 445 둘 다 사용이 되지만,

이전 버전의 Windows에서는 139 포트를 기본으로 사용한 것으로 보이고,

Windows가 버전업이 되면서 445 포트를 사용하는 것 같습니다.

고로 요즘 대부분의 방화벽에서는, 기본적으로 Windows 파일공유 서비스에서 사용하는

서비스 포트를 모두 막고있는 실정입니다.

업무에 사용되는 Windows 파일공유를 대체하기 위한 방안으로 얼마전 SSHFS라는 서비스를 찾았습니다.

출시된지는 상당히 오래된 것으로 보이고, 물론 사용 안정성이나 성능에 대해서는 확인이 필요합니다.

오픈 소스 기반으로 출시가 되었고, 현재는 상용 프로그램도 다수 나와 있습니다.

A서버가 SSH서비스를 제공하고 있다고 할 경우,

B클라이언트에서 A서버의 지정한 파일시스템(또는 디렉토리)을

마치 로컬 파일시스템처럼 사용할 수 있도록 해주는 프로그램입니다.

A에는 공유할 디렉토리를 만드는 작업 외에 특별한 작업은 없습니다. (기 존재 디렉토리를 서비스용으로 사용한다면 별도 작업 없음)

물론 B에서는 SSHFS를 사용하기 위한 프로그램(라이브러리)가 필요합니다.

○ SSHFS
   - 오픈소스 솔루션으로 성능 및 안정성에 대해 담보할 수 없음. 성능 및 안정성 테스트 필요
   - SAMBA 대용으로 SSH 프로토콜을 활용하므로, 보안 문제 해결
   - SSHFS를 사용할 수 있도록 하는 클라이언트 프로그램 필요

    상용 프로그램의 경우 1 copy 당 100불 정도의 비용 발생 (SFTPNetDrive 100불, NetDrive 50불 등)

    . 상용 프로그램 : SFTPNetDrive(개인용도 무료), NetDrive, ExpanDrive
    . 오픈소스 프로그램 : win-sshfs, sshfs-win

○ 사용 방법

- Linux

Fedora EPEL에서 fuse-sshfs 라는 프로그램을 설치하여 사용이 가능

- Windows (win-sshfs)

사전에 dokany라는 라이브러리 설치 (win-sshfs와 호환되는 버전 필요)

win-sshfs 프로그램 설치 (리부팅 필요)

- Windows (SFTPNetDrive)

SFTPNetDrive 설치 후 바로 사용 가능

※ 자세한 방법 및 다운로드는 아래 URL들을 참고

[Docker] Docker Registry HTTP API V2

SYPER — Wed, 4 Apr 2018 11:27:09 +0900

HTTP API V2

Estimated reading time: 127 minutes

Docker Registry HTTP API V2

Introduction

Docker Registry HTTP API 는 docker 엔진에 이미지의 배포를 용이하게 할 수있는 프로토콜입니다. 이것은 도커 이미지에 대한 정보를 관리하고 배포 할 수있는 서비스인 도커 레지스트리 인스턴스와 상호 작용합니다. 이 사양은 Docker Registry HTTP API V2 로 알려진이 API 버전 2의 작동을 다룹니다 .
V1 레지스트리 프로토콜을 사용할 수 있지만, 이 아키텍처에는 몇 가지 문제가 있습니다. 이 사양의 주된 드라이버는 docker / docker # 8093 에서 다루는, docker 이미지 형식에 대한 일련의 변경 사항들입니다 . 새로운 자체 포함 이미지 매니페스트는 이미지 정의를 단순화하고 보안을 향상시킵니다. 이 사양은 성능 향상, 대역폭 사용 감소 및 백엔드 손상 가능성 감소를 위해 매니페스트 형식의 새로운 속성을 활용하여 해당 작업을 기반으로합니다.
이 사양에 이르는 관련 세부 정보 및 기록은 다음 문제를 참조하십시오.

도커 / 도커 # 8093
도커 / 도커 # 9015
도커 / 도커 - 레지스트리 # 612

Scope

이 사양은 도커 레지스트리와 도커 코어 간의 상호 작용에 대한 URL 레이아웃과 프로토콜을 다룹니다. 이것은 docker core registry API와 docker-registry의 재 작성에 영향을 미친다. Docker 레지스트리 구현은 다른 API 끝점을 구현할 수 있지만, 이 사양에서는 다루지 않습니다.
여기에는 다음과 같은 기능이 포함됩니다.
네임 스페이스 지향 URI 레이아웃
V2 이미지 매니페스트 형식의 PUSH / PULL 레지스트리 서버
재개 가능 계층 PUSH 지원
V2 클라이언트 라이브러리 구현
인증 및 권한 부여 지원이 이 사양에 영향을 미치지 만 프로토콜의 세부 사항은 향후 사양으로 남습니다. 관련 헤더 정의 및 오류 코드는 클라이언트가 마주 칠 수있는 것에 대한 표시를 제공합니다.

FUTURE

이 사양을 자르는 과정에서 논의 된 기능이 있습니다. 다음은 불완전한 목록입니다.
변경할 수없는 이미지 참조
다중 아키텍처 지원
v2 호환성 표현에서 마이그레이션
이것들은이 규격의 범위 밖이거나 다른 규격의 범위 또는 향후 버전으로 연기 된 특징을 나타낼 수있다.

Use Cases

대부분의 경우 이전 레지스트리 API의 사용 사례가 새 버전에 적용됩니다. 차별화 된 사용 사례는 아래에서 다룹니다.

IMAGE VERIFICATION

도커 엔진 인스턴스는 "LATEST"태그와 함께 "LIBRARY/UBUNTU"라는 이름의 검증 된 이미지를 실행하려고합니다. 엔진이 레지스트리에 접속하여 “LIBRARY/UBUNTU:LATEST”에 대한 매니페스트를 요청합니다. 신뢰할 수없는 레지스트리는 매니페스트를 반환합니다. 각각의 레이어를 다운로드하기 전에 엔진은 매니페스트의 서명을 확인하여 콘텐츠가 신뢰할 수있는 원본에서 생성되었으며 변조가 발생하지 않았는지 확인합니다. 각 레이어를 다운로드 한 후 엔진은 레이어의 DIGEST를 확인하여 매니페스트가 지정한 내용과 일치하는지 확인합니다.

RESUMABLE PUSH

회사 X의 빌드 서버는 이미지 레이어 전송을 완료하기 전에 도커 레지스트리에 대한 연결을 잃었습니다. 연결이 돌아온 후에 빌드 서버는 이미지를 다시 업로드하려고 시도합니다. 레지스트리는 이전에 업로드가 부분적으로 시도되었음을 빌드 서버에 알립니다. 빌드 서버는 이미지 파일을 완성하기 위해 나머지 데이터만을 보내는 것으로 응답합니다.

RESUMABLE PULL

회사 X는 더 많은 연결 문제가 있지만 이번에는 배포 데이터 센터에 있습니다. 이미지를 다운로드 할 때 연결이 완료되기 전에 중단됩니다. 클라이언트는 부분 데이터를 유지하고 HTTP `RANGE`요청을 사용 하여 반복되는 데이터 다운로드를 방지합니다.

LAYER UPLOAD DE-DUPLICATION

회사 Y의 빌드 시스템은 빌드 프로세스 A와 B에서 두 개의 동일한 도커 레이어를 만듭니다. 빌드 프로세스 A가 B 이전에 레이어 업로드를 완료합니다. 프로세스 B가 레이어 업로드를 시도하면 레지스트리는 레이어가 이미 알려져 있기 때문에 필요하지 않음을 나타냅니다.

프로세스 A와 B가 같은 레이어를 동시에 업로드하면 두 작업이 모두 진행되고 완료된 첫 번째 작업이 레지스트리에 저장됩니다 (참고 : 일부 잠금 메커니즘이있는 닥치는 것을 방지하기 위해이 작업을 수정할 수 있습니다).

Overview

이 절에서는 클라이언트 플로우와 API 엔드 포인트의 세부 사항에 대해 설명합니다. 새 API의 URI 레이아웃은 네임 스페이스를 활용하여 풍부한 인증 및 권한 부여 모델을 지원하도록 구성됩니다. 모든 엔드 포인트에는 API 버전 및 저장소 이름이 접두어로 붙습니다.

/v2/<name>/

예를 들어 library/ubuntu 저장소로 작동하는 API 엔드 포인트인 경우 URI 접두사는 다음과 같습니다.

/v2/library/ubuntu/

이 스키마는 다양한 방식으로 제어 할 수있는 URI 접두사 및 http 메서드를 사용하여 다양한 작업과 메서드에 대한 풍부한 액세스 제어를 제공합니다.

전통적으로 저장소 이름은 항상 각 경로 구성 요소가 30 자 미만인 두 경로 구성 요소였습니다. V2 레지스트리 API는 이것을 강요하지 않습니다. 저장소 이름에 대한 규칙은 다음과 같습니다.

저장소 이름은 경로 구성 요소 로 나뉩니다 . 저장소 이름의 구성 요소는 하나 이상의 소문자, 영숫자 문자 여야하며 선택적으로 마침표, 대시 또는 밑줄로 구분됩니다. 보다 엄격하게 말하면 정규 표현식과 일치해야합니다 [a-z0-9]+(?:[._-][a-z0-9]+)*.
저장소 이름에 둘 이상의 경로 구성 요소가있는 경우에는 슬래시 ( "/")로 구분해야합니다.
슬래시를 포함하여 저장소 이름의 총 길이는 256 자 미만이어야합니다.

이러한 이름 요구 사항 은 레지스트리 API 에만 적용되며 다른 도커 생태계 구성 요소가 지원하는 항목의 수퍼 세트를 수락해야합니다.

모든 엔드 포인트는 적절한 경우 공격적인 http 캐싱, 압축 및 범위 헤더를 지원해야합니다. 새로운 API는 HTTP 의미를 가능한 한 활용하려고 시도하지만 표준에서 타겟 기능을 구현하기 위해 끊어 질 수 있습니다.

개별 종점에 대한 자세한 내용은 세부 정보 섹션을 참조하십시오 .

Errors

관련 절에서 자세히 다루는 실행 가능한 실패 조건은 json response body 4xx 응답의 일부로 보고됩니다. 하나 이상의 오류가 다음 형식으로 반환됩니다:

{
    "errors:" [{
            "code": <error identifier>,
            "message": <message describing condition>,
            "detail": <unstructured>
        },
        ...
    ]
}

이 code필드는 고유한 식별자가되며, 모든 대문자는 규칙에 따라 밑줄이 그어져 있습니다. message필드는 사람이 읽을 수있는 문자열입니다. 선택적 detail필드는 클라이언트가 문제를 해결하는 데 사용할 수있는 정보를 제공하는 임의의 json 데이터를 포함할 수 있습니다.

클라이언트가 특정 오류 코드에 대해 조치를 취할 수있는 반면 레지스트리는 새로운 오류 코드를 추가 할 수 있습니다. 모든 클라이언트 구현은, API 호환성을 손상시키지 않고 오류 코드를 추가 할 수 있도록, 알 수없는 오류 코드를 UNKNOWN으로 처리해야 합니다. 사양의 목적 상 오류 코드는 추가될 수만 있으며 절대로 제거되지 않습니다.

모든 오류 코드의 전체 계정을 보려면 오류 섹션을 참조하십시오 .

API Version Check

/v2/에 설치된, 최소 엔드 포인트는 응답 상태에 따라 버전 지원 정보를 제공합니다. 요청 형식은 다음과 같습니다:

GET /v2/

만일 200 OK응답이 반환되면, 레지스트리는 V2 (.1) 레지스트리 API를 구현하고 클라이언트는 V2 수행작업을 안전하게 진행할 수 있습니다. 선택적으로 응답에는 응답 본문에서 지원되는 경로에 대한 정보가 포함될 수 있습니다. 클라이언트는 이 데이터를 무시할 준비가되어 있어야합니다.

만일 401 Unauthorized응답이 반환되면, 클라이언트는 "WWW 인증"헤더의 내용에 따라 조치를 취해야 하며, 다시 엔드 포인트를 시도해야합니다. 액세스 제어 설정에 따라 클라이언트는 이 검사가 성공하더라도 다른 자원에 대해 인증해야 할 수 있습니다.

만일 404 Not Found응답 상태, 또는 그 외의 돌발적인 상태가 반환되면, 클라이언트는 레지스트리가 API의 V2를 구현하지 않는다는 가정하에 진행해야합니다.

200 OK또는 401 Unauthorized응답이 반환될 때, "Docker-Distribution-API-Version" 헤더가 "registry / 2.0"으로 설정되어야 합니다. 클라이언트는이 헤더 값을 요구하여 엔드 포인트가 이 API를 제공하는지 판별 할 수 있습니다. 이 헤더를 생략하면 클라이언트가 이전 API 버전으로 원복 할 수 있습니다.

Content Digests

이 API 디자인은 콘텐츠 주소 지정 기능에 의해 크게 좌우됩니다 . 이 디자인의 핵심은 콘텐츠 주소 지정 가능 식별자의 개념입니다. 충돌 방지 해시 바이트를 사용하여 콘텐츠를 고유하게 식별합니다. 이러한 식별자는 공통 알고리즘 을 선택하여 독립적으로 계산하고 검증 할 수 있습니다 . 그러한 식별자가 안전한 방식으로 통신 될 수 있다면, 안전하지 않은 소스로부터 콘텐츠를 검색하여 독립적으로 계산할 수 있고 올바른 콘텐츠가 확보되었는지 확인할 수 있습니다. 간단히 말해 식별자는 콘텐츠의 속성입니다.

다른 개념을 명확히하기 위해이 식별자를 다이제스트 라고 부릅니다 . 다이제스트 (A)의 구성된 직렬화 해시 결과 알고리즘 과 육각 부. 이 알고리즘 은 다이제스트를 계산하는 데 사용 된 방법론을 식별합니다. 육각 부 해시의 헥스 인코딩 결과이다.

다음 문법과 일치 하는 다이제스트 문자열을 정의합니다 .

digest      := algorithm ":" hex
algorithm   := /[A-Fa-f0-9_+.-]+/
hex         := /[A-Fa-f0-9]+/

다이제스트의 몇 가지 예 는 다음과 같습니다.

요람	기술
sha256 : 6c3c624b58dbbcd3c0dd82b4c53f04194d1247c6eebdaab7c610cf7d66709b3b	일반적인 sha256 기반 다이제스트

이 알고리즘 은 다양한 알고리즘을 구현할 수 있지만 준수하는 구현에는 sha256을 사용해야합니다. 해시를 계산하기 전에 입력을 많이 처리하는 것이 다이제스트 의 고유성을 떨어 뜨리는 것을 방지하기 위해 권장되지 않지만 일관된 식별자를 보장하기 위해 일부 정규화가 수행 될 수 있습니다.

요약 코드에서 간단한 예제를 사용하여 다이제스트 계산을 보여줍니다.

let C = 'a small string'
let B = sha256(C)
let D = 'sha256:' + EncodeHex(B)
let ID(C) = D

위의 예에서 우리는 bytestring을 C함수에 전달했습니다.이 함수 SHA256는 바이트 B해시 인 바이트 테스트를 반환합니다 C. D알고리즘을의 16 진수 인코딩으로 연결 가져옵니다 B. 그런 다음 식별자를 Cto ID(C) 와 같게 정의합니다 D. 다이제스트는 D식별자와 독립적으로 계산 하여 비교하여 확인할 수 있습니다 ID(C).

다이제스트 헤더

http 콘텐츠의 확인을 제공하기 위해 모든 응답에 `Docker-Content-Digest`헤더 가 포함될 수 있습니다 . 여기에는 응답에 반환 된 대상 엔터티의 다이제스트가 포함됩니다. 얼룩에 대해서, 이것은 얼룩 전체 내용입니다. 매니페스트의 경우 이는 JWS 페이로드라고도하는 서명 콘텐츠가없는 매니 페스트 바디입니다. 다이제스트 계산에 일반적으로 사용되는 정규화는 매니페스트와 같이 콘텐츠의 mediatype에 따라 달라질 수 있습니다.
클라이언트는 헤더를 무시하도록 선택하거나 내용 무결성 및 전송 보안을 보장하기 위해 헤더를 확인할 수 있습니다. 이것은 다이제스트로 가져올 때 가장 중요합니다. 보안을 유지하기 위해 콘텐츠를 가져 오는 데 사용 된 다이제스트에 대해 콘텐츠를 확인해야합니다. 때로는 반환 된 다이제스트가 요청을 시작하는 데 사용 된 다이제스트와 다를 수 있습니다. 이러한 다이제스트는 다른 도메인 에서 온 것으로 간주되므로알고리즘에 대해 다른 값을 갖습니다 . 이 경우 클라이언트는 두 도메인의 다이제스트를 확인하거나 서버의 다이제스트를 무시할 수 있습니다. 보안을 유지하기 위해 클라이언트 는 항상 콘텐츠 를 가져 오는 데 사용 된 다이제스트 와 비교하여 콘텐츠를 확인 해야합니다 .
중요 : 경우 다이제스트 콘텐츠를 가져 오기 위해 사용하는 경우, 클라이언트가 동일한가 그것을 확인하기 위해 컨텐츠를 취득하는 데 사용 다이제스트 사용해야합니다. 헤더 `Docker-Content-Digest`는 "로컬"다이제스트를 통해 신뢰되어서는 안됩니다.

Pulling An Image

"이미지"는 JSON 매니페스트와 개별 레이어 파일의 조합입니다. 이미지를 가져 오는 프로세스는이 두 구성 요소를 검색하는 것을 중심으로합니다.

이미지를 가져 오는 첫 번째 단계는 매니페스트를 검색하는 것입니다. 참조를 위해 레지스트리의 관련 매니페스트 필드는 다음과 같습니다.
들 기술
name 이미지의 이름.
tag 이 이미지 버전의 태그입니다.
fsLayers 레이어 설명자 목록 (다이제스트 포함)
signagure
매니페스트 콘텐츠를 확인하는 데 사용되는 JWS
매니페스트 형식에 대한 자세한 내용은 docker / docker # 8093을 참조하십시오 .
매니 페스트가 준비되면 클라이언트는 이름과 레이어가 유효한지 확인하기 위해 서명을 확인해야합니다. 일단 확인되면 클라이언트는 다이제스트를 사용하여 개별 레이어를 다운로드합니다. 레이어는 다이제스트로 고정 된 V2 레지스트리 API에 BLOB로 저장됩니다.

들	기술
name	이미지의 이름.
tag	이 이미지 버전의 태그입니다.
fsLayers	레이어 설명자 목록 (다이제스트 포함)
signagure	매니페스트 콘텐츠를 확인하는 데 사용되는 JWS

이미지 매니페스트 가져 오기

이미지 매니페스트는 다음 url로 가져올 수 있습니다.

GET /v2/<name>/manifests/<reference>

name및 reference매개 변수는 이미지를 확인하고 필요합니다. 참조는 태그 또는 다이제스트를 포함 할 수 있습니다.

클라이언트는 지원하는 매니 페스트 콘텐츠 유형을 나타내는 Accept 헤더를 포함해야합니다. 매니페스트 형식 및 해당 콘텐츠 형식에 대한 자세한 내용은 manifest-v2-1.md 및 manifest-v2-2.md를 참조하십시오 . 응답이 성공적이면 Content-Type 헤더는 반환되는 매니페스트 유형을 나타냅니다.

404 Not Found이미지가 레지스트리에 알 수없는 경우 응답이 반환됩니다. 이미지가 존재하고 응답이 성공하면 다음 형식으로 이미지 매니페스트가 반환됩니다 (자세한 내용은 docker / docker # 8093 참조).

{
   "name": <name>,
   "tag": <tag>,
   "fsLayers": [
      {
         "blobSum": <digest>
      },
      ...
    ]
   ],
   "history": <v1 images>,
   "signature": <JWS>
}

클라이언트는 레이어를 가져 오기 전에 반환 된 매니페스트 서명을 확인해야합니다.

기존 매니페스트

이미지 매니페스트는 다음 URL을 통해 존재 여부를 확인할 수 있습니다.

HEAD /v2/<name>/manifests/<reference>

name및 reference매개 변수는 이미지를 확인하고 필요합니다. 참조는 태그 또는 다이제스트를 포함 할 수 있습니다.

404 Not Found이미지가 레지스트리에 알 수없는 경우 응답이 반환됩니다. 이미지가 존재하고 응답이 성공적이면 응답은 다음과 같습니다.

200 OK
Content-Length: <length of manifest>
Docker-Content-Digest: <digest>

레이어 당기기

레이어는 레지스트리의 얼룩 부분에 저장되며 다이제스트가 입력됩니다. 레이어를 당기는 것은 표준 http 요청에 의해 수행됩니다. URL은 다음과 같습니다.

GET /v2/<name>/blobs/<digest>

계층에 대한 액세스 name는 저장소의 gated에 의해 처리 되지만 레지스트리에 의해 고유하게 식별됩니다 digest.

이 엔드 포인트는 계층을 다운로드하기 위해 307 (302 <HTTP 1.1)의 다른 서비스로 리디렉션 할 수 있으며 클라이언트는 리디렉션을 처리 할 준비가되어 있어야합니다.

이 엔드 포인트는 이미지 레이어에 대한 적극적인 HTTP 캐싱을 지원해야합니다. Etags, 수정 날짜 및 기타 캐시 제어 헤더에 대한 지원이 포함되어야합니다. 증분 다운로드를 허용하려면 Range요청도 지원되어야합니다.

Pushing An Image

이미지를 밀면 당김과 반대 순서로 작동합니다. 이미지 매니페스트를 어셈블 한 후 클라이언트는 먼저 개별 레이어를 푸시해야합니다. 레이어가 레지스트리에 완전히 푸시되면 클라이언트는 서명 된 매니페스트를 업로드해야합니다.

프로세스의 각 단계에 대한 자세한 내용은 다음 절에서 다룹니다.

레이어 밀기

모든 레이어 업로드는 두 단계를 사용하여 업로드 프로세스를 관리합니다. 첫 번째 단계는 레지스트리 서비스에서 업로드를 시작하고 두 번째 단계를 수행하기위한 url을 반환합니다. 두 번째 단계에서는 업로드 URL을 사용하여 실제 데이터를 전송합니다. 업로드는 데이터를 푸시하고 업로드 상태를 확인하는 데 사용할 수있는 URL을 반환하는 POST 요청으로 시작됩니다.
`Location`헤더는 각 요청 후 업로드 위치를 통신하는 데 사용됩니다. 이 사양에서는 변경되지 않지만 클라이언트는 API에서 반환 한 최신 값을 사용해야합니다.

업로드 시작

프로세스를 시작하려면 POST 요청을 다음 형식으로 실행해야합니다.

POST /v2/<name>/blobs/uploads/

이 요청의 매개 변수는 레이어가 링크 될 이미지 네임 스페이스입니다. 이 요청에 대한 응답은 아래에서 다룹니다.

기존 레이어

레이어의 존재 여부 HEAD는 blob 저장소 API에 대한 요청을 통해 확인할 수 있습니다 . 요청은 다음과 같이 형식화되어야합니다.

HEAD /v2/<name>/blobs/<digest>

다이제스트가 지정된 계층 digest이 사용 가능하면 실제 본문 내용이없는 200 OK 응답이 수신됩니다 (http 사양에 따름). 응답은 다음과 같이 보입니다.

200 OK
Content-Length: <length of blob>
Docker-Content-Digest: <digest>

이 응답을 받으면 클라이언트는 해당 이름으로 레지스트리에서 이미 사용 가능한 것으로 간주하고 추가 작업을 수행하지 않아야합니다. 바이너리 다이제스트는 기존 레지스트리 계층과 다를 수 있지만 다이제스트는 일치한다는 점에 유의하십시오.

레이어 업로드

POST 요청이 성공 202 Accepted하면 Location헤더에 업로드 URL과 함께 응답이 반환됩니다 .

202 Accepted
Location: /v2/<name>/blobs/uploads/<uuid>
Range: bytes=0-<offset>
Content-Length: 0
Docker-Upload-UUID: <uuid>

나머지 업로드 프로세스는 Location헤더 에서 "업로드 URL"이라고하는 반환 된 URL을 사용하여 수행 할 수 있습니다 . 업로드 URL에 대한 모든 응답은 데이터 전송 여부에 관계없이이 형식으로 제공됩니다. 헤더 의 URI 형식 ( /v2/<name>/blobs/uploads/<uuid>) Location이 지정 되었지만 클라이언트는이 헤더를 불투명 한 URL로 취급해야하며 절대 어셈블하지 않아야합니다. uuid매개 변수가 실제 UUID 일 수 있지만 이 제안은 형식에 제약을 부과하지 않으며 클라이언트는 절대로 어떤 것도 부과해서는 안됩니다.

클라이언트가 로컬 업로드 상태와 원격 업로드 상태를 연관시켜야하는 경우 Docker-Upload-UUID헤더 의 내용을 사용해야합니다. 이러한 ID는 재개 가능한 업로드를 구현할 때 마지막으로 사용한 위치 헤더를 사용하는 데 사용될 수 있습니다.

업로드 진행

업로드 프로세스의 진행 및 청크 조정은 Range헤더를 통해 조정됩니다 . 이것이 Range 헤더 의 비표준적인 사용이지만 , 많이 사용되는 API에서 유사한 접근법의 예가 있습니다. 방금 시작한 업로드의 경우, 1000 바이트의 레이어 파일을 예로 들면 Range헤더는 다음과 같습니다.

Range: bytes=0-0

업로드 상태를 확인하려면 업로드 URL에 GET 요청을 보냅니다.

GET /v2/<name>/blobs/uploads/<uuid>
Host: <registry host>

응답은 204 상태를 반환한다는 점을 제외하고는 위와 유사합니다.

204 No Content
Location: /v2/<name>/blobs/uploads/<uuid>
Range: bytes=0-<offset>
Docker-Upload-UUID: <uuid>

HTTP Range헤더 바이트 범위는 포괄적이며 비표준 유스 케이스 에서조차이를 준수합니다.

모 놀리 식 업로드

모 놀리 식 업로드는 단일 청크가있는 청크 업로드이며 청크의 복잡성을 피하고자하는 고객이 선호 할 수 있습니다. "모노 리식 (monolithic)"업로드를 수행하려면 제공된 전체 URL에 콘텐츠 전체를 넣으면됩니다.

PUT /v2/<name>/blobs/uploads/<uuid>?digest=<digest>
Content-Length: <size of layer>
Content-Type: application/octet-stream

<Layer Binary Data>

"digest"매개 변수는 PUT 요청에 포함되어야합니다. 매개 변수 및 예상 응답에 대한 자세한 내용은 완료된 업로드 섹션을 참조하십시오.

청크 업로드

청크 업로드를 수행하기 위해 클라이언트는 범위 헤더를 지정하고 레이어 파일의 해당 부분 만 포함 할 수 있습니다.

PATCH /v2/<name>/blobs/uploads/<uuid>
Content-Length: <size of chunk>
Content-Range: <start of range>-<end of range>
Content-Type: application/octet-stream

<Layer Chunk Binary Data>

서버가 계층 적 청크 분할을 순서대로 수신해야한다는 것을 제외하고는 계층 청크 분할에 대한 시행이 없습니다. 서버는 최소 청크 크기를 적용 할 수 있습니다. 서버가 청크를 받아 들일 수없는 경우 416 Requested Range Not Satisfiable 응답이 반환되고 Range현재 상태를 나타내는 헤더 가 포함됩니다 .

416 Requested Range Not Satisfiable
Location: /v2/<name>/blobs/uploads/<uuid>
Range: 0-<last valid range>
Content-Length: 0
Docker-Upload-UUID: <uuid>

이 응답을받은 경우 클라이언트는 "마지막 유효 범위"에서 다시 시작하여 후속 청크를 업로드해야합니다. A 416은 다음 조건 하에서 반환됩니다 :

콘텐츠 범위 헤더 형식이 잘못되었습니다.
순서가 잘못된 청크 : 다음 청크의 범위는 이전 응답의 "마지막 유효 범위"바로 다음에 시작해야합니다.

청크가 업로드의 일부로 허용 되면 현재 업로드 상태 202 Accepted의 Range헤더를 포함하여 응답이 반환됩니다 .

202 Accepted
Location: /v2/<name>/blobs/uploads/<uuid>
Range: bytes=0-<offset>
Content-Length: 0
Docker-Upload-UUID: <uuid>

완료된 업로드

업로드가 완료된 것으로 간주 되려면 클라이언트가 PUT 다이제스트 매개 변수를 사용하여 업로드 끝점 에서 요청을 제출해야합니다 . 제공되지 않으면 업로드가 완료된 것으로 간주되지 않습니다. 최종 청크의 형식은 다음과 같습니다.

PUT /v2/<name>/blob/uploads/<uuid>?digest=<digest>
Content-Length: <size of chunk>
Content-Range: <start of range>-<end of range>
Content-Type: application/octet-stream

<Last Layer Chunk Binary Data>

선택적으로 모든 청크가 이미 업로드 된 경우, 매개 변수와 길이가 0 인 PUT요청 digest이 전송되어 업로드를 완료하고 유효성을 검사 할 수 있습니다. 여러 개의 "다이제스트"매개 변수가 다른 다이제스트와 함께 제공 될 수 있습니다. 서버는 아무도 또는 모두를 확인하지 않을 수 있지만 합니다 내용이 거부되는 경우 클라이언트에 통지.

마지막 청크가 수신되고 레이어의 유효성이 검사되면 클라이언트는 다음과 같은 201 Created응답 을 받게됩니다 .

201 Created
Location: /v2/<name>/blobs/<digest>
Content-Length: 0
Docker-Content-Digest: <digest>

Location헤더는 허용 레이어 파일에 액세스 할 수있는 레지스트리 URL이 포함됩니다. Docker-Content-Digest헤더 제공된 다이제스트 다를 수 업로드 블롭의 정규 다이제스트를 반환한다. 대부분의 클라이언트는 값을 무시할 수 있지만 사용되는 경우 클라이언트는 업로드 된 BLOB 데이터에 대해 값을 확인해야합니다.

다이제스트 매개 변수

"digest"매개 변수는 성공적인 전송 확인을 지원하는 불투명 한 매개 변수로 설계되었습니다. 예를 들어 HTTP URI 매개 변수는 다음과 같습니다.

sha256:6c3c624b58dbbcd3c0dd82b4c53f04194d1247c6eebdaab7c610cf7d66709b3b

이 매개 변수가 주어지면 레지스트리는 제공된 내용이이 다이제스트와 일치하는지 확인합니다.

업로드 취소

업로드 엔드 포인트에 DELETE 요청을 발행하여 업로드를 취소 할 수 있습니다. 형식은 다음과 같습니다.

DELETE /v2/<name>/blobs/uploads/<uuid>

이 요청이 발행 된 후 업로드 uuid는 더 이상 유효하지 않으며 레지스트리 서버는 모든 중간 데이터를 덤프합니다. 업로드가 완료되지 않은 경우 시간 초과가되지만 클라이언트는 치명적인 오류가 발생해도 http 요청을 발행 할 수 있으면이 요청을해야합니다.

교차 저장소 브 로브 마운트

blob은 클라이언트가 읽기 액세스 권한을 가진 다른 저장소에서 마운트되어 레지스트리에 이미 알려진 BLOB를 업로드 할 필요가 없습니다. 업로드 대신 blob 마운트를 실행하려면 POST 요청을 다음 형식으로 실행해야합니다.

POST /v2/<name>/blobs/uploads/?mount=<digest>&from=<repository name>
Content-Length: 0

BLOB가 성공적으로 마운트되면 클라이언트는 다음과 같은 201 Created 응답 을 받게됩니다 .

201 Created
Location: /v2/<name>/blobs/<digest>
Content-Length: 0
Docker-Content-Digest: <digest>

잘못된 저장소 또는 다이제스트 인수로 인해 마운트가 실패하면 레지스트리가 표준 업로드 동작으로 돌아가고 헤더에 202 Accepted업로드 URL과 함께 a 를 반환합니다 Location.

202 Accepted
Location: /v2/<name>/blobs/uploads/<uuid>
Range: bytes=0-<offset>
Content-Length: 0
Docker-Upload-UUID: <uuid>

이 동작은 저장소 탑재 쿼리 매개 변수를 인식하지 못하는 이전 버전의 레지스트리와 일치합니다.

주 : 클라이언트는 blob 마운트를 지원하지 않는 레지스트리와 예상 저장소에없는 blob을 구별하기 위해 원본 저장소에 BLOB의 존재를 확인하기 위해 HEAD 요청을 발행 할 수 있습니다.

오류

502, 503 또는 504 오류가 수신되면 클라이언트는 해당 재시도 메커니즘을 준수하는 일시적인 조건으로 인해 다운로드가 계속 될 수 있다고 가정해야합니다. 다른 5xx 오류는 터미널로 처리되어야합니다.
업로드에 문제가 있으면 문제를 나타내는 4xx 오류가 반환됩니다. 4xx 응답 (위에 나온 것처럼 416 제외)을 수신하면 업로드가 실패한 것으로 간주되어 클라이언트가 적절한 조치를 취해야합니다.
업로드 URL은 영원히 사용할 수 없습니다. 업로드 uuid가 레지스트리에 알려지지 않은 경우 `404 Not Found`응답이 반환되고 클라이언트는 업로드 프로세스를 다시 시작해야합니다.

Deleting a Layer

해당 `name`및을 통해 레지스트리에서 레이어를 삭제할 수 있습니다 `digest`. 삭제 요청은 다음 요청 형식으로 발행 될 수 있습니다.

DELETE /v2/<name>/blobs/<digest>

BLOB가 존재하고 성공적으로 삭제되면 다음과 같은 응답이 발행됩니다.

202 Accepted
Content-Length: None

BLOB가 이미 삭제되었거나 존재하지 않으면 404 Not Found 응답이 대신 발행됩니다.

레지스트리의 매니페스트에서 참조하는 레이어가 삭제 된 경우 전체 이미지를 해석 할 수 없습니다.

이미지 매니페스트 푸시

이미지의 모든 레이어가 업로드되면 클라이언트는 이미지 목록을 업로드 할 수 있습니다. 다음 요청 형식을 사용하여 이미지를 푸시 할 수 있습니다.

PUT /v2/<name>/manifests/<reference>
Content-Type: <manifest media type>

{
   "name": <name>,
   "tag": <tag>,
   "fsLayers": [
      {
         "blobSum": <digest>
      },
      ...
    ]
   ],
   "history": <v1 images>,
   "signature": <JWS>,
   ...
}

name및 reference응답 본문의 필드는 URL에 지정된 일치해야합니다. reference필드는 "태그"이거나 "소화"수 있습니다. 콘텐츠 유형은 manifest-v2-1.md 및 manifest-v2-2.md에 지정된대로 업로드되는 매니페스트의 유형과 일치해야합니다 .

매니페스트를 푸는 데 문제가있는 경우 관련 4xx 응답이 JSON 오류 메시지와 함께 반환됩니다. 가능한 오류 코드에 대한 자세한 내용은 PUT Manifest 섹션을 참조하십시오.

하나 이상의 레이어가 레지스트리에 알려지지 않은 경우 BLOB_UNKNOWN오류가 반환됩니다. detail오류 응답의 필드는있을 것이다 digest누락 된 덩어리를 식별하는 필드. 알 수없는 각 blob에 대해 오류가 리턴됩니다. 응답 형식은 다음과 같습니다.

{
    "errors:" [{
            "code": "BLOB_UNKNOWN",
            "message": "blob unknown to registry",
            "detail": {
                "digest": <digest>
            }
        },
        ...
    ]
}

Listing Repositories

이미지는 저장소 로 알려진 콜렉션에 저장 `name`되며, API 스펙 전체에서 볼 수 있듯이, 키가 있습니다. 레지스트리 인스턴스는 여러 저장소를 포함 할 수 있습니다. 사용 가능한 리포지토리 목록은 카탈로그를 통해 사용할 수 있습니다 .

주어진 레지스트리에 대한 카탈로그는 다음 요청으로 검색 될 수 있습니다.

GET /v2/_catalog

응답 형식은 다음과 같습니다.

200 OK
Content-Type: application/json

{
  "repositories": [
    <name>,
    ...
  ]
}

응답의 내용은 레지스트리 구현에 따라 다릅니다. 일부 레지스트리는 전체 카탈로그 출력을 제공하거나 미러링 기능을 제공하는 경우 사용자의 액세스 수준에 따라 제한하거나 업스트림 결과를 생략 할 수 있습니다. 따라서 카탈로그 목록에 저장소가있는 경우에만 레지스트리 가 요청시 저장소에 대한 액세스를 제공 할 수 있습니다 . 반대로 항목이 누락 되었다고해서 레지스트리에 저장소 가 없다는 의미는 아닙니다. 더 간결하게, 저장소의 존재는 그것이라고이 아닌 것을 보장 하지 있습니다.

저장소가 많은 레지스트리의 경우이 응답이 상당히 클 수 있습니다. 이러한 응답이 예상되는 경우 페이지 매김을 사용해야합니다. 레지스트리는 페이지 매김이 명시 적으로 요청되지 않은 경우에도 반환되는 응답의 양을 제한 할 수 있습니다. 이 경우 Link결과와 함께 헤더가 반환되며 페이지 순서가 처음 요청 된 것처럼 링크를 따라 후속 결과를 얻을 수 있습니다.

Link머리글에 대한 자세한 내용은 페이지 매김 섹션을 참조하십시오 .

쪽수 매기기

페이지가 매겨진 카탈로그 결과는 n요청 URL에 매개 변수를 추가하여 검색 n결과 를 결과 로 제한해야한다고 선언 하여 검색 할 수 있습니다 . 페이지 매김 된 흐름 시작은 다음과 같이 시작됩니다.

GET /v2/_catalog?n=<integer>

위의 예는 결과 세트를 어휘로 나열하여 결과의 수를 제한하여 카탈로그 응답을 리턴하도록 지정합니다 n. 그러한 요청에 대한 응답은 다음과 같습니다.

200 OK
Content-Type: application/json
Link: <<url>?n=<n from the request>&last=<last repository in response>>; rel="next"

{
  "repositories": [
    <name>,
    ...
  ]
}

위 결과 집합 의 첫 번째 n 항목이 포함 됩니다. 다음 n 항목 을 얻으 려면 인수 last에 값이 있는 URL을 만들 수 있습니다 repositories[len(repositories)-1]. 실제로 더 많은 결과가있는 경우 다음 블록의 URL은 RFC5988 Link 헤더에 "다음"관계로 인코딩됩니다 . Link헤더 의 존재는 전체 결과 세트가 리턴되지 않았고 또 다른 요청이 _ 행되어야한다는 클라이언트와 통신합니다. 헤더가 없으면 클라이언트는 모든 결과가 수신되었다고 간주 할 수 있습니다.

참고 : 위 요청 템플릿에서 대괄호가 필요하다는 것을 유의하십시오. 예를 들어, url은http://example.com/v2/_catalog?n=20&last=b헤더의 값입니다 <http://example.com/v2/_catalog?n=20&last=b>; rel="next". 자세한 내용은 RFC5988 을 참조하십시오.

호환되는 클라이언트 구현은 Link결과를 선형 적으로 진행할 때 항상 헤더 값을 사용해야합니다 . 클라이언트는 카탈로그에서 건너 뛸 URL을 생성 할 수 있습니다.

다음 결과 세트를 얻으려면 클라이언트가 설명 된 Link헤더에 인코딩 된 URL을 사용하여 다음과 같이 요청을 발행합니다 .

GET /v2/_catalog?n=<n from the request>&last=<last repository value from previous response>

Link헤더가 더 이상 설정되지 않을 때까지 위의 프로세스를 반복해야합니다 .

카탈로그 결과 세트는 어휘 적으로 정렬 된 목록으로 추상적으로 표현되며, 목록의 위치는 질의 용어로 지정할 수 있습니다 last. 응답의 항목은 ~로 지정된 용어 다음 에 시작 됩니다.lastn

last예를 들어 설명 할 때 의 동작 은 매우 간단합니다. 레지스트리에 다음과 같은 리포지토리가 있다고 가정 해 보겠습니다.

a
b
c
d

의 값이있는 경우 n인 2 및 B는 상기 제 1 응답을 반환한다. 응답에 반환 헤더는 것 2 마지막 세트로 설정 B :Linkn

Link: <<url>?n=2&last=b>; rel="next"

그런 다음 클라이언트는 Link 헤더 에서 위의 값을 사용하여 c 및 d 값을 수신하여 요청을 발행 할 수 있습니다 . 주 n마지막 응답 제에 따라 변경 될 수 있거나 완전히 서버 구현에 따라 생략한다.

Listing Image Tags

주어진 저장소 아래에 모든 태그를 나열해야 할 수도 있습니다. 이미지 저장소의 태그는 다음 요청으로 검색 할 수 있습니다.

GET /v2/<name>/tags/list

응답 형식은 다음과 같습니다.

200 OK
Content-Type: application/json

{
    "name": <name>,
    "tags": [
        <tag>,
        ...
    ]
}

많은 수의 태그가있는 리포지토리의 경우이 응답은 상당히 클 수 있습니다. 그러한 응답이 예상되면 페이지 매김을 사용해야합니다.

쪽수 매기기

페이지 매김 태그 결과는 위에 설명 된 요청 URL에 적절한 매개 변수를 추가하여 검색 할 수 있습니다. 태그 페이지 매김의 동작은 카탈로그 페이지 매김에 지정된 동작과 동일합니다. 우리는 차이점을 강조하기위한 간단한 흐름을 다룹니다.

페이지 매김 된 플로우의 시작은 다음과 같이 시작될 수 있습니다.

GET /v2/<name>/tags/list?n=<integer>

위의 예는 결과 세트의 시작부터 어휘 적으로 순서화 된 태그 응답을 반환하도록 지정하여 결과의 수를 제한합니다 n. 그러한 요청에 대한 응답은 다음과 같습니다.

200 OK
Content-Type: application/json
Link: <<url>?n=<n from the request>&last=<last tag value from previous response>>; rel="next"

{
  "name": <name>,
  "tags": [
    <tag>,
    ...
  ]
}

다음 결과 세트를 얻으려면 클라이언트가 RFC5988 Link 헤더에 인코딩 된 값을 사용하여 다음과 같이 요청을 발행합니다 .

GET /v2/<name>/tags/list?n=<n from the request>&last=<last tag value from previous response>

The above process should then be repeated until the Link header is no longer set in the response. The behavior of the lastparameter, the provided response result, lexical ordering and encoding of the Link header are identical to that of catalog pagination.

Deleting an Image

An image may be deleted from the registry via its name and reference. A delete may be issued with the following request format:

DELETE /v2/<name>/manifests/<reference>

For deletes, reference must be a digest or the delete will fail. If the image exists and has been successfully deleted, the following response will be issued:

202 Accepted
Content-Length: None

If the image had already been deleted or did not exist, a 404 Not Found response will be issued instead.

Note When deleting a manifest from a registry version 2.3 or later, the following header must be used when HEAD or GET-ing the manifest to obtain the correct digest to delete:

Accept: application/vnd.docker.distribution.manifest.v2+json

for more details, see: compatibility.md

Detail

참고 :이 섹션은 아직 작성 중입니다. 이행을 위해 아래의 세부 사항이 위에서 설명한 요청 흐름과 다른 경우 아래 섹션을 수정해야합니다. 일치하면이 메모를 삭제해야합니다.
끝점의 동작은이 섹션에서 경로 및 엔터티로 구성되어 자세히 설명됩니다. 헤더, 매개 변수 및 본문 형식을 포함하여 요청 및 응답의 모든 측면을 다룹니다. 요청 및 성공 및 실패와 함께 대응하는 응답의 예가 열거됩니다.
주 : 엔드 포인트 세부 사항의 섹션은 예제 요청, 요청 설명, 그 요청에 대한 정보 순으로 정렬됩니다.
메소드 및 URI 목록은 아래 표에 나와 있습니다.
방법 통로 실재 기술
GET `/v2/` 베이스 엔드 포인트가 Docker Registry API V2를 구현하는지 확인하십시오.
GET `/v2/<name>/tags/list` 태그 에 의해 식별 된 저장소 아래에 태그를 가져옵니다 `name`.
GET `/v2/<name>/manifests/<reference>` 명백한 에 의해 식별 된 매니페스트를 가져 `name`오고 `reference`어디 `reference`에서 태그 또는 다이제스트가 될 수 있습니다. `HEAD`요청이 모든 데이터를 수신하지 않고 자원 정보를 획득하기 위해,이 엔드 포인트에 발행 할 수있다.
PUT `/v2/<name>/manifests/<reference>` 명백한 에 의해 확인 된 매니페스트를 넣어 `name`및 `reference`곳 `reference`태그를 수 또는 소화 할 수 있습니다.
DELETE `/v2/<name>/manifests/<reference>` 명백한 `name`and로 식별 된 매니페스트를 삭제하십시오 `reference`. 매니페스트는에 의해서만 삭제 될 수 있습니다 `digest`.
GET `/v2/<name>/blobs/<digest>` 얼룩 에 의해 식별 된 레지스트리에서 BLOB를 검색하십시오 `digest`. `HEAD`요청이 모든 데이터를 수신하지 않고 자원 정보를 획득하기 위해,이 엔드 포인트에 발행 할 수있다.
DELETE `/v2/<name>/blobs/<digest>` 얼룩 블롭에 의해 확인 삭제 `name`및`digest`
POST `/v2/<name>/blobs/uploads/` 블롭 업로드 시작 재개 가능한 BLOB 업로드를 시작하십시오. 업로드가 완료되면 업로드 위치가 제공되어 업로드가 완료됩니다. 선택적으로 `digest`매개 변수가 있으면 요청 본문이 단일 요청으로 업로드를 완료하는 데 사용됩니다.
GET `/v2/<name>/blobs/uploads/<uuid>` 블롭 업로드 에 의해 식별 된 업로드 상태 검색 `uuid`. 이 엔드 포인트의 주요 목적은 재개 가능한 업로드의 현재 상태를 해결하는 것입니다.
PATCH `/v2/<name>/blobs/uploads/<uuid>` 블롭 업로드 지정된 업로드에 대한 데이터 청크 업로드
PUT `/v2/<name>/blobs/uploads/<uuid>` 블롭 업로드 에 의해 지정된 업로드를 완료하고 `uuid`선택적으로 본문을 최종 청크로 추가합니다.
DELETE `/v2/<name>/blobs/uploads/<uuid>` 블롭 업로드 미해결의 업로드 프로세스를 취소하고 관련 자원을 릴리스하십시오. 이것이 호출되지 않으면, 끝나지 않은 업로드가 결국 타임 아웃됩니다.
GET `/v2/_catalog` 목록 레지스트리에서 사용할 수있는 정렬 된 정렬 된 json 목록을 검색하십시오.
각 엔드 포인트에 대한 세부 사항은 다음 절에서 다룹니다.

방법	통로	실재	기술
GET	`/v2/`	베이스	엔드 포인트가 Docker Registry API V2를 구현하는지 확인하십시오.
GET	`/v2/<name>/tags/list`	태그	에 의해 식별 된 저장소 아래에 태그를 가져옵니다 `name`.
GET	`/v2/<name>/manifests/<reference>`	명백한	에 의해 식별 된 매니페스트를 가져 `name`오고 `reference`어디 `reference`에서 태그 또는 다이제스트가 될 수 있습니다. `HEAD`요청이 모든 데이터를 수신하지 않고 자원 정보를 획득하기 위해,이 엔드 포인트에 발행 할 수있다.
PUT	`/v2/<name>/manifests/<reference>`	명백한	에 의해 확인 된 매니페스트를 넣어 `name`및 `reference`곳 `reference`태그를 수 또는 소화 할 수 있습니다.
DELETE	`/v2/<name>/manifests/<reference>`	명백한	`name`and로 식별 된 매니페스트를 삭제하십시오 `reference`. 매니페스트는에 의해서만 삭제 될 수 있습니다 `digest`.
GET	`/v2/<name>/blobs/<digest>`	얼룩	에 의해 식별 된 레지스트리에서 BLOB를 검색하십시오 `digest`. `HEAD`요청이 모든 데이터를 수신하지 않고 자원 정보를 획득하기 위해,이 엔드 포인트에 발행 할 수있다.
DELETE	`/v2/<name>/blobs/<digest>`	얼룩	블롭에 의해 확인 삭제 `name`및`digest`
POST	`/v2/<name>/blobs/uploads/`	블롭 업로드 시작	재개 가능한 BLOB 업로드를 시작하십시오. 업로드가 완료되면 업로드 위치가 제공되어 업로드가 완료됩니다. 선택적으로 `digest`매개 변수가 있으면 요청 본문이 단일 요청으로 업로드를 완료하는 데 사용됩니다.
GET	`/v2/<name>/blobs/uploads/<uuid>`	블롭 업로드	에 의해 식별 된 업로드 상태 검색 `uuid`. 이 엔드 포인트의 주요 목적은 재개 가능한 업로드의 현재 상태를 해결하는 것입니다.
PATCH	`/v2/<name>/blobs/uploads/<uuid>`	블롭 업로드	지정된 업로드에 대한 데이터 청크 업로드
PUT	`/v2/<name>/blobs/uploads/<uuid>`	블롭 업로드	에 의해 지정된 업로드를 완료하고 `uuid`선택적으로 본문을 최종 청크로 추가합니다.
DELETE	`/v2/<name>/blobs/uploads/<uuid>`	블롭 업로드	미해결의 업로드 프로세스를 취소하고 관련 자원을 릴리스하십시오. 이것이 호출되지 않으면, 끝나지 않은 업로드가 결국 타임 아웃됩니다.
GET	`/v2/_catalog`	목록	레지스트리에서 사용할 수있는 정렬 된 정렬 된 json 목록을 검색하십시오.

오류

API를 통해 발생한 오류 코드는 다음 표에서 열거됩니다.
암호 메시지 기술
`BLOB_UNKNOWN` 레지스트리에 알려지지 않은 blob 이 오류는 blob이 지정된 저장소의 레지스트리에 알려지지 않은 경우 리턴 될 수 있습니다.이것은 표준 get과 함께 반환되거나 매니페스트가 업로드 중에 알 수없는 레이어를 참조하는 경우 반환 될 수 있습니다.
`BLOB_UPLOAD_INVALID` 얼룩 업로드 잘못되었습니다. BLOB 업로드에 오류가 발생하여 더 이상 진행할 수 없습니다.
`BLOB_UPLOAD_UNKNOWN` 레지스트리에 blob 업로드 알 수 없음 BLOB 업로드가 취소되었거나 시작되지 않은 경우이 오류 코드가 반환 될 수 있습니다.
`DIGEST_INVALID` 제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음 BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.
`MANIFEST_BLOB_UNKNOWN` 레지스트리에 알려지지 않은 blob 매니페스트 blob이 레지스트리에 알려지지 않은 경우이 오류가 반환 될 수 있습니다.
`MANIFEST_INVALID` 매니 페스트가 유효하지 않음 업로드하는 동안 매니페스트는 유효성을 확인하는 몇 가지 검사를 거칩니다. 이러한 검사가 실패하면보다 구체적인 오류가 포함되어 있지 않으면이 오류가 반환 될 수 있습니다. 세부 정보에는 실패한 유효성 검사에 대한 정보가 포함됩니다.
`MANIFEST_UNKNOWN` 알 수없는 명부 이름 및 태그로 식별 된 매니페스트가 저장소에서 알 수없는 경우이 오류가 반환됩니다.
`MANIFEST_UNVERIFIED` 서명 검증에 실패했다 매니페스트 업로드 중에 매니페스트가 서명 확인에 실패하면이 오류가 반환됩니다.
`NAME_INVALID` 잘못된 저장소 이름 매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`NAME_UNKNOWN` 레지스트리에 알 수없는 저장소 이름 조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.
`SIZE_INVALID` 제공된 길이가 콘텐츠 길이와 일치하지 않습니다. 레이어가 업로드되면 제공된 크기가 업로드 된 내용과 비교하여 검사됩니다. 일치하지 않으면이 오류가 리턴됩니다.
`TAG_INVALID` 매니페스트 태그가 URI와 일치하지 않습니다. 매니페스트 업로드 중에 매니페스트의 태그가 uri 태그와 일치하지 않으면이 오류가 반환됩니다.
`UNAUTHORIZED` 인증 필요 액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.
`DENIED` 리소스에 대한 요청 된 액세스가 거부되었습니다. 액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.
`UNSUPPORTED` 작업이 지원되지 않습니다. 구현이 누락되었거나 잘못된 매개 변수 집합으로 인해 작업이 지원되지 않았습니다.

암호	메시지	기술
`BLOB_UNKNOWN`	레지스트리에 알려지지 않은 blob	이 오류는 blob이 지정된 저장소의 레지스트리에 알려지지 않은 경우 리턴 될 수 있습니다.이것은 표준 get과 함께 반환되거나 매니페스트가 업로드 중에 알 수없는 레이어를 참조하는 경우 반환 될 수 있습니다.
`BLOB_UPLOAD_INVALID`	얼룩 업로드 잘못되었습니다.	BLOB 업로드에 오류가 발생하여 더 이상 진행할 수 없습니다.
`BLOB_UPLOAD_UNKNOWN`	레지스트리에 blob 업로드 알 수 없음	BLOB 업로드가 취소되었거나 시작되지 않은 경우이 오류 코드가 반환 될 수 있습니다.
`DIGEST_INVALID`	제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음	BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.
`MANIFEST_BLOB_UNKNOWN`	레지스트리에 알려지지 않은 blob	매니페스트 blob이 레지스트리에 알려지지 않은 경우이 오류가 반환 될 수 있습니다.
`MANIFEST_INVALID`	매니 페스트가 유효하지 않음	업로드하는 동안 매니페스트는 유효성을 확인하는 몇 가지 검사를 거칩니다. 이러한 검사가 실패하면보다 구체적인 오류가 포함되어 있지 않으면이 오류가 반환 될 수 있습니다. 세부 정보에는 실패한 유효성 검사에 대한 정보가 포함됩니다.
`MANIFEST_UNKNOWN`	알 수없는 명부	이름 및 태그로 식별 된 매니페스트가 저장소에서 알 수없는 경우이 오류가 반환됩니다.
`MANIFEST_UNVERIFIED`	서명 검증에 실패했다	매니페스트 업로드 중에 매니페스트가 서명 확인에 실패하면이 오류가 반환됩니다.
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.
`SIZE_INVALID`	제공된 길이가 콘텐츠 길이와 일치하지 않습니다.	레이어가 업로드되면 제공된 크기가 업로드 된 내용과 비교하여 검사됩니다. 일치하지 않으면이 오류가 리턴됩니다.
`TAG_INVALID`	매니페스트 태그가 URI와 일치하지 않습니다.	매니페스트 업로드 중에 매니페스트의 태그가 uri 태그와 일치하지 않으면이 오류가 반환됩니다.
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.
`UNSUPPORTED`	작업이 지원되지 않습니다.	구현이 누락되었거나 잘못된 매개 변수 집합으로 인해 작업이 지원되지 않았습니다.

베이스

기본 V2 API 경로. 일반적으로이 기능은 경량 버전 확인 및 레지스트리 인증의 유효성 검사에 사용할 수 있습니다.

GET BASE

엔드 포인트가 Docker Registry API V2를 구현하는지 확인하십시오.

GET /v2/
Host: <registry host>
Authorization: <scheme> <token>

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.

성공시 : OK

200 OK

API는 V2 프로토콜을 구현하며 액세스 할 수 있습니다.

실패시 : 찾을 수 없음

404 Not Found

레지스트리는 V2 API를 구현하지 않습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

태그에 대한 정보를 검색하십시오.

GET 태그

에 의해 식별 된 저장소 아래에 태그를 가져옵니다 `name`.

태그가 지정된 태그

GET /v2/<name>/tags/list?n=<integer>&last=<integer>

지정된 리포지터리 (repository)의 태그의 일부를 돌려줍니다.

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`name`	통로	대상 저장소의 이름.
`n`	질문	각 응답의 항목 수를 제한하십시오. 존재하지 않으면 모든 항목이 리턴됩니다.
`last`	질문	결과 집합에는 어휘 적으로 값이 포함됩니다.

성공시 : OK

200 OK
Content-Length: <length>
Link: <<url>?n=<last n value>&last=<last entry from response>>; rel="next"
Content-Type: application/json; charset=utf-8

{
    "name": <name>,
    "tags": [
        <tag>,
        ...
    ],
}

명명 된 저장소의 태그 목록입니다.

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.
`Link`	RFC5988 준수 rel = 다음 결과 집합에 대한 URL로 'next'(사용 가능한 경우)

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

명백한

매니페스트를 생성, 업데이트, 삭제 및 검색합니다.

GET MANIFEST

에 의해 식별 된 매니페스트를 가져 name오고 reference어디 reference에서 태그 또는 다이제스트가 될 수 있습니다. HEAD요청이 모든 데이터를 수신하지 않고 자원 정보를 획득하기 위해,이 엔드 포인트에 발행 할 수있다.

GET /v2/<name>/manifests/<reference>
Host: <registry host>
Authorization: <scheme> <token>

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`name`	통로	대상 저장소의 이름.
`reference`	통로	타겟 매니페스트의 태그 또는 다이제스트.

성공시 : OK

200 OK
Docker-Content-Digest: <digest>
Content-Type: <media type of manifest>

{
   "name": <name>,
   "tag": <tag>,
   "fsLayers": [
      {
         "blobSum": "<digest>"
      },
      ...
    ]
   ],
   "history": <v1 images>,
   "signature": <JWS>
}

매니페스트에 의해 확인 name및reference . 내용을 사용하여 지정된 이미지를 실행하는 데 필요한 자원을 식별하고 해결할 수 있습니다.

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Docker-Content-Digest`	요청 된 대상 콘텐츠의 요약입니다.

실패시 : 잘못된 요청

400 Bad Request
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

이름이나 참조가 잘못되었습니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`TAG_INVALID`	매니페스트 태그가 URI와 일치하지 않습니다.	매니페스트 업로드 중에 매니페스트의 태그가 uri 태그와 일치하지 않으면이 오류가 반환됩니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

PUT MANIFEST

에 의해 확인 된 매니페스트를 넣어 name및 reference곳 reference태그를 수 또는 소화 할 수 있습니다.

PUT /v2/<name>/manifests/<reference>
Host: <registry host>
Authorization: <scheme> <token>
Content-Type: <media type of manifest>

{
   "name": <name>,
   "tag": <tag>,
   "fsLayers": [
      {
         "blobSum": "<digest>"
      },
      ...
    ]
   ],
   "history": <v1 images>,
   "signature": <JWS>
}

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`name`	통로	대상 저장소의 이름.
`reference`	통로	타겟 매니페스트의 태그 또는 다이제스트.

성공시 : 생성됨

201 Created
Location: <url>
Content-Length: 0
Docker-Content-Digest: <digest>

매니페스트는 레지스트리에서 수락되었으며 지정된 name및 아래에 저장됩니다.tag .

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Location`	업로드 된 매니페스트의 표준 위치 URL입니다.
`Content-Length`	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.
`Docker-Content-Digest`	요청 된 대상 콘텐츠의 요약입니다.

실패시 : Invalid Manifest

400 Bad Request
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

수신 된 매니페스트는 오류 코드에 설명 된대로 어떤 식 으로든 잘못되었습니다. 클라이언트가 문제를 해결하고 요청을 다시 시도해야합니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`TAG_INVALID`	매니페스트 태그가 URI와 일치하지 않습니다.	매니페스트 업로드 중에 매니페스트의 태그가 uri 태그와 일치하지 않으면이 오류가 반환됩니다.
`MANIFEST_INVALID`	매니 페스트가 유효하지 않음	업로드하는 동안 매니페스트는 유효성을 확인하는 몇 가지 검사를 거칩니다. 이러한 검사가 실패하면보다 구체적인 오류가 포함되어 있지 않으면이 오류가 반환 될 수 있습니다. 세부 정보에는 실패한 유효성 검사에 대한 정보가 포함됩니다.
`MANIFEST_UNVERIFIED`	서명 검증에 실패했다	매니페스트 업로드 중에 매니페스트가 서명 확인에 실패하면이 오류가 반환됩니다.
`BLOB_UNKNOWN`	레지스트리에 알려지지 않은 blob	이 오류는 blob이 지정된 저장소의 레지스트리에 알려지지 않은 경우 리턴 될 수 있습니다.이것은 표준 get과 함께 반환되거나 매니페스트가 업로드 중에 알 수없는 레이어를 참조하는 경우 반환 될 수 있습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

실패시 : 누락 된 레이어 (들)

400 Bad Request
Content-Type: application/json; charset=utf-8

{
    "errors:" [{
            "code": "BLOB_UNKNOWN",
            "message": "blob unknown to registry",
            "detail": {
                "digest": "<digest>"
            }
        },
        ...
    ]
}

매니페스트 업로드 중에 하나 이상의 레이어가 누락되었을 수 있습니다. 그렇다면 누락 된 레이어가 오류 응답에 열거됩니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`BLOB_UNKNOWN`	레지스트리에 알려지지 않은 blob	이 오류는 blob이 지정된 저장소의 레지스트리에 알려지지 않은 경우 리턴 될 수 있습니다. 이것은 표준 get과 함께 반환되거나 매니페스트가 업로드 중에 알 수없는 레이어를 참조하는 경우 반환 될 수 있습니다.

실패시 : 허용되지 않음

405 Method Not Allowed

레지스트리가 풀다운 캐시로 구성되었거나 다른 이유로 인해 매니페스트 풋이 허용되지 않습니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNSUPPORTED`	작업이 지원되지 않습니다.	구현이 누락되었거나 잘못된 매개 변수 집합으로 인해 작업이 지원되지 않았습니다.

매니페스트 삭제

nameand로 식별 된 매니페스트를 삭제하십시오 reference. 매니페스트는에 의해서만 삭제 될 수 있습니다 digest.

DELETE /v2/<name>/manifests/<reference>
Host: <registry host>
Authorization: <scheme> <token>

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`name`	통로	대상 저장소의 이름.
`reference`	통로	타겟 매니페스트의 태그 또는 다이제스트.

성공시 : 수락 됨

202 Accepted

실패시 : 잘못된 이름 또는 참조

400 Bad Request
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

지정된 name또는reference 유효하지 않아 삭제를 진행할 수 없습니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`TAG_INVALID`	매니페스트 태그가 URI와 일치하지 않습니다.	매니페스트 업로드 중에 매니페스트의 태그가 uri 태그와 일치하지 않으면이 오류가 반환됩니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

실패시 : 알 수없는 Manifest

404 Not Found
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

레지스트리에 지정 되지 않았 name거나 reference알 수 없으며 삭제를 진행할 수 없습니다. 클라이언트는이 응답이 반환되면 매니페스트가 이미 삭제 된 것으로 간주 할 수 있습니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.
`MANIFEST_UNKNOWN`	알 수없는 명부	이름 및 태그로 식별 된 매니페스트가 저장소에서 알 수없는 경우이 오류가 반환됩니다.

실패시 : 허용되지 않음

405 Method Not Allowed

레지스트리가 풀다운 캐시로 구성 delete되었거나 비활성화 된 상태 이므로 매니페스트 삭제가 허용되지 않습니다 .

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNSUPPORTED`	작업이 지원되지 않습니다.	구현이 누락되었거나 잘못된 매개 변수 집합으로 인해 작업이 지원되지 않았습니다.

얼룩

`name`및로 식별되는 얼룩에 대한 작업 `digest`. 다이제스트로 레이어를 가져 오거나 삭제하는 데 사용됩니다.

블롭 가져 오기

에 의해 식별 된 레지스트리에서 BLOB를 검색하십시오 `digest`. 에이`HEAD`요청이 모든 데이터를 수신하지 않고 자원 정보를 획득하기 위해,이 엔드 포인트에 발행 할 수있다.

블랍 가져 오기

GET /v2/<name>/blobs/<digest>
Host: <registry host>
Authorization: <scheme> <token>

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`name`	통로	대상 저장소의 이름.
`digest`	통로	원하는 BLOB 다이제스트.

성공시 : OK

200 OK
Content-Length: <length>
Docker-Content-Digest: <digest>
Content-Type: application/octet-stream

<blob binary data>

에 의해 식별 된 얼룩 digest 사용 가능합니다. 얼룩 내용은 요청 본문에 표시됩니다.

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Content-Length`	요청 된 BLOB 내용의 길이입니다.
`Docker-Content-Digest`	요청 된 대상 콘텐츠의 요약입니다.

성공시 : 임시 리디렉션

307 Temporary Redirect
Location: <blob location>
Docker-Content-Digest: <digest>

에 의해 식별 된 얼룩 digest은 제공된 위치에서 사용할 수 있습니다.

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Location`	레이어에 액세스 할 수있는 위치입니다.
`Docker-Content-Digest`	요청 된 대상 콘텐츠의 요약입니다.

실패시 : 잘못된 요청

400 Bad Request
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

올바르지 name않거나 유효하지 않은 요청과 같이 클라이언트가 해결해야하는 요청에 문제가 있습니다 tag.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`DIGEST_INVALID`	제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음	BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.

실패시 : 찾을 수 없음

404 Not Found
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

name및로 식별되는 얼룩digest 은 레지스트리에 알려지지 않습니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.
`BLOB_UNKNOWN`	레지스트리에 알려지지 않은 blob	이 오류는 blob이 지정된 저장소의 레지스트리에 알려지지 않은 경우 리턴 될 수 있습니다. 이것은 표준 get과 함께 반환되거나 매니페스트가 업로드 중에 알 수없는 레이어를 참조하는 경우 반환 될 수 있습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

얼룩 부분 가져 오기

GET /v2/<name>/blobs/<digest>
Host: <registry host>
Authorization: <scheme> <token>
Range: bytes=<start>-<end>

이 종점은 RFC7233 호환 범위 요청을 지원할 수도 있습니다. 지원은 HEAD 요청을 발행하여 감지 할 수 있습니다. 헤더 Accept-Range: bytes가 반환되면 부분 요청을 가져 오는 데 범위 요청을 사용할 수 있습니다.

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`Range`	머리글	BLOB 청크를 지정하는 HTTP 범위 헤더입니다.
`name`	통로	대상 저장소의 이름.
`digest`	통로	원하는 BLOB 다이제스트.

성공시 : 부분 콘텐츠

206 Partial Content
Content-Length: <length>
Content-Range: bytes <start>-<end>/<size>
Content-Type: application/octet-stream

<blob binary data>

에 의해 식별 된 얼룩 digest 사용 가능합니다. 지정된 Blob 내용 청크가 요청 본문에 표시됩니다.

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Content-Length`	요청 된 BLOB 청크의 길이.
`Content-Range`	BLOB 청크의 콘텐츠 범위.

실패시 : 잘못된 요청

400 Bad Request
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

올바르지 name않거나 유효하지 않은 요청과 같이 클라이언트가 해결해야하는 요청에 문제가 있습니다 tag.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`DIGEST_INVALID`	제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음	BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.

실패시 : 찾을 수 없음

404 Not Found
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.
`BLOB_UNKNOWN`	레지스트리에 알려지지 않은 blob	이 오류는 blob이 지정된 저장소의 레지스트리에 알려지지 않은 경우 리턴 될 수 있습니다. 이것은 표준 get과 함께 반환되거나 매니페스트가 업로드 중에 알 수없는 레이어를 참조하는 경우 반환 될 수 있습니다.

실패시 : 요청 된 범위가 만족스럽지 않음

416 Requested Range Not Satisfiable

요청한 콘텐츠에 대해 범위 지정을 만족시킬 수 없습니다. 범위가 올바르게 형식이 지정되지 않았거나 범위가 콘텐츠의 유효한 크기를 벗어난 경우 이러한 현상이 발생할 수 있습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

BLOB 삭제

블롭에 의해 확인 삭제 name및digest

DELETE /v2/<name>/blobs/<digest>
Host: <registry host>
Authorization: <scheme> <token>

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`name`	통로	대상 저장소의 이름.
`digest`	통로	원하는 BLOB 다이제스트.

성공시 : 수락 됨

202 Accepted
Content-Length: 0
Docker-Content-Digest: <digest>

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Content-Length`	0
`Docker-Content-Digest`	요청 된 대상 콘텐츠의 요약입니다.

실패시 : 잘못된 이름 또는 다이제스트

400 Bad Request

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DIGEST_INVALID`	제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음	BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.

실패시 : 찾을 수 없음

404 Not Found
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

블롭, 식별 name및digest 은 레지스트리에 알려지지 않습니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.
`BLOB_UNKNOWN`	레지스트리에 알려지지 않은 blob	이 오류는 blob이 지정된 저장소의 레지스트리에 알려지지 않은 경우 리턴 될 수 있습니다. 이것은 표준 get과 함께 반환되거나 매니페스트가 업로드 중에 알 수없는 레이어를 참조하는 경우 반환 될 수 있습니다.

실패시 : 메소드가 허용되지 않음

405 Method Not Allowed
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

레지스트리가 풀다운 캐시로 구성 delete되었거나 비활성화 된 상태 이므로 블롭 삭제가 허용되지 않습니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNSUPPORTED`	작업이 지원되지 않습니다.	구현이 누락되었거나 잘못된 매개 변수 집합으로 인해 작업이 지원되지 않았습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

블롭 업로드 시작

BLOB 업로드를 시작하십시오. 이 끝점은 재개 가능한 업로드 또는 단일 업로드를 만드는 데 사용할 수 있습니다.

POST가 BLOB 업로드를 시작합니다.

재개 가능한 BLOB 업로드를 시작하십시오. 업로드가 완료되면 업로드 위치가 제공되어 업로드가 완료됩니다. 선택적으로 `digest`매개 변수가 있으면 요청 본문이 단일 요청으로 업로드를 완료하는 데 사용됩니다.

모 놀리 식 블롭 업로드 시작

POST /v2/<name>/blobs/uploads/?digest=<digest>
Host: <registry host>
Authorization: <scheme> <token>
Content-Length: <length of blob>
Content-Type: application/octect-stream

<binary data>

digest단일 요청 에서 매개 변수로 식별 된 BLOB를 업로드합니다 . 이 업로드는 복구 할 수있는 오류가 반환되지 않는 이상 재개 할 수 없습니다.

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`Content-Length`	머리글
`name`	통로	대상 저장소의 이름.
`digest`	질문	업로드 된 BLOB의 다이제스트. 존재하는 경우 업로드는 단일 요청으로 결과 본문의 내용과 함께 완료됩니다.

성공시 : 생성됨

201 Created
Location: <blob location>
Content-Length: 0
Docker-Upload-UUID: <uuid>

BLOB는 레지스트리에 생성되었으며 제공된 위치에서 사용할 수 있습니다.

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Location`
`Content-Length`	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.
`Docker-Upload-UUID`	현재 요청에 대한 docker 업로드 uuid를 식별합니다.

실패시 : 잘못된 이름 또는 다이제스트

400 Bad Request

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DIGEST_INVALID`	제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음	BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.

실패시 : 허용되지 않음

405 Method Not Allowed

레지스트리가 풀 스루 캐시로 구성되었거나 다른 이유로 인해 Blob 업로드가 허용되지 않습니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNSUPPORTED`	작업이 지원되지 않습니다.	구현이 누락되었거나 잘못된 매개 변수 집합으로 인해 작업이 지원되지 않았습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

재개 가능한 Blob 업로드 시작

POST /v2/<name>/blobs/uploads/
Host: <registry host>
Authorization: <scheme> <token>
Content-Length: 0

빈 요청 본문을 가진 재개 가능한 BLOB 업로드를 시작하십시오.

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`Content-Length`	머리글	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.
`name`	통로	대상 저장소의 이름.

성공시 : 수락 됨

202 Accepted
Content-Length: 0
Location: /v2/<name>/blobs/uploads/<uuid>
Range: 0-0
Docker-Upload-UUID: <uuid>

업로드가 생성되었습니다. Location헤더는 업로드를 완료해야합니다. 응답은 GET반환 된 내용에 대한 요청 과 동일해야합니다.Location 헤더 .

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Content-Length`	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.
`Location`	생성 된 업로드 위치입니다. 클라이언트는 업로드를 완료하고 필요한 경우 매개 변수를 추가하기 위해 내용을 축 어적으로 사용해야합니다.
`Range`	업로드 진행 상황을 나타내는 범위 헤더입니다. 업로드를 시작하면 콘텐츠가 수신되지 않으므로 빈 범위가 반환됩니다.
`Docker-Upload-UUID`	현재 요청에 대한 docker 업로드 uuid를 식별합니다.

실패시 : 잘못된 이름 또는 다이제스트

400 Bad Request

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DIGEST_INVALID`	제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음	BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

마운트 블롭

POST /v2/<name>/blobs/uploads/?mount=<digest>&from=<repository name>
Host: <registry host>
Authorization: <scheme> <token>
Content-Length: 0

마운트에 의해 식별 된 얼룩 mount다른 저장소 매개 변수로 .

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`Content-Length`	머리글	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.
`name`	통로	대상 저장소의 이름.
`mount`	질문	소스 저장소에서 마운트 할 blob의 다이제스트.
`from`	질문	소스 저장소의 이름.

성공시 : 생성됨

201 Created
Location: <blob location>
Content-Length: 0
Docker-Upload-UUID: <uuid>

BLOB는 저장소에 마운트되었으며 제공된 위치에서 사용할 수 있습니다.

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Location`
`Content-Length`	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.
`Docker-Upload-UUID`	현재 요청에 대한 docker 업로드 uuid를 식별합니다.

실패시 : 잘못된 이름 또는 다이제스트

400 Bad Request

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DIGEST_INVALID`	제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음	BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.

실패시 : 허용되지 않음

405 Method Not Allowed

레지스트리가 풀다운 캐시로 구성되었거나 다른 이유로 인해 Blob 마운트가 허용되지 않습니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNSUPPORTED`	작업이 지원되지 않습니다.	구현이 누락되었거나 잘못된 매개 변수 집합으로 인해 작업이 지원되지 않았습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

블롭 업로드

BLOB 업로드와 상호 작용합니다. 클라이언트는이 끝점에 대한 URL을 절대로 조합해서는 안되며 `Location`관련 API 요청 의 헤더를 통해서만 가져와야합니다. 그만큼`Location`헤더 및 해당 매개 변수는 업로드 관련 API 호출을 통해 반환 된 최신 값을 사용하여, 클라이언트에 의해 보존되어야한다.

블롭 업로드하기

에 의해 식별 된 업로드 상태 검색 uuid. 이 엔드 포인트의 주요 목적은 재개 가능한 업로드의 현재 상태를 해결하는 것입니다.

GET /v2/<name>/blobs/uploads/<uuid>
Host: <registry host>
Authorization: <scheme> <token>

에서 업로드 한 현재 업로드 진행률을 가져옵니다. Range헤더에 .

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`name`	통로	대상 저장소의 이름.
`uuid`	통로	업로드를 식별하는 uuid. 이 필드는 일치하는 문자를 허용 할 수 있습니다 `[a-zA-Z0-9-_.=]+`.

성공시 : 업로드 진행

204 No Content
Range: 0-<offset>
Content-Length: 0
Docker-Upload-UUID: <uuid>

업로드가 알려져 있고 진행 중입니다. 마지막으로 수신 된 오프셋은Range헤더 .

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Range`	업로드의 현재 진행 상태를 나타내는 범위.
`Content-Length`	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.
`Docker-Upload-UUID`	현재 요청에 대한 docker 업로드 uuid를 식별합니다.

실패시 : 잘못된 요청

400 Bad Request
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

업로드를 처리하는 중에 오류가 발생했으며 다시 시작해야합니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DIGEST_INVALID`	제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음	BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`BLOB_UPLOAD_INVALID`	얼룩 업로드 잘못되었습니다.	BLOB 업로드에 오류가 발생하여 더 이상 진행할 수 없습니다.

실패시 : 찾을 수 없음

404 Not Found
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

업로드가 레지스트리에 알려지지 않았습니다. 업로드를 다시 시작해야합니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`BLOB_UPLOAD_UNKNOWN`	레지스트리에 blob 업로드 알 수 없음	BLOB 업로드가 취소되었거나 시작되지 않은 경우이 오류 코드가 반환 될 수 있습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

패치 블롭 업로드

지정된 업로드에 대한 데이터 청크 업로드

스트림 업로드

PATCH /v2/<name>/blobs/uploads/<uuid>
Host: <registry host>
Authorization: <scheme> <token>
Content-Type: application/octet-stream

<binary data>

업로드를 완료하지 않고 업로드 할 데이터 스트림을 업로드하십시오.

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`name`	통로	대상 저장소의 이름.
`uuid`	통로	업로드를 식별하는 uuid. 이 필드는 일치하는 문자를 허용 할 수 있습니다 `[a-zA-Z0-9-_.=]+`.

성공시 : 데이터 허용

204 No Content
Location: /v2/<name>/blobs/uploads/<uuid>
Range: 0-<offset>
Content-Length: 0
Docker-Upload-UUID: <uuid>

데이터 스트림이 승인되었으며 현재 진행률이 범위 헤더에서 사용 가능합니다. 업데이트 된 업로드 위치는 Location헤더 에서 사용할 수 있습니다 .

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Location`	업로드 위치입니다. 클라이언트는 각 요청 후에 변경 사항을 가정해야합니다. 클라이언트는 업로드를 완료하고 필요한 경우 매개 변수를 추가하기 위해 내용을 축 어적으로 사용해야합니다.
`Range`	업로드의 현재 진행 상태를 나타내는 범위.
`Content-Length`	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.
`Docker-Upload-UUID`	현재 요청에 대한 docker 업로드 uuid를 식별합니다.

실패시 : 잘못된 요청

400 Bad Request
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

업로드를 처리하는 중에 오류가 발생했으며 다시 시작해야합니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DIGEST_INVALID`	제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음	BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`BLOB_UPLOAD_INVALID`	얼룩 업로드 잘못되었습니다.	BLOB 업로드에 오류가 발생하여 더 이상 진행할 수 없습니다.

실패시 : 찾을 수 없음

404 Not Found
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

업로드가 레지스트리에 알려지지 않았습니다. 업로드를 다시 시작해야합니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`BLOB_UPLOAD_UNKNOWN`	레지스트리에 blob 업로드 알 수 없음	BLOB 업로드가 취소되었거나 시작되지 않은 경우이 오류 코드가 반환 될 수 있습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

청크 업로드

PATCH /v2/<name>/blobs/uploads/<uuid>
Host: <registry host>
Authorization: <scheme> <token>
Content-Range: <start of range>-<end of range, inclusive>
Content-Length: <length of chunk>
Content-Type: application/octet-stream

<binary chunk>

업로드를 완료하지 않고 지정된 업로드로 데이터 덩어리를 업로드하십시오. 데이터가 지정된 내용 범위에 업로드됩니다.

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`Content-Range`	머리글	본문에 의해 표시되는 원하는 내용 블록을 식별하는 바이트 범위. 시작은 상태 점검 + 1을 통해 검색된 종료 오프셋이어야합니다. 이것은 비표준 `Content-Range`헤더 사용에주의하십시오 .
`Content-Length`	머리글	업로드되는 청크의 길이로 요청 본문의 길이에 해당합니다.
`name`	통로	대상 저장소의 이름.
`uuid`	통로	업로드를 식별하는 uuid. 이 필드는 일치하는 문자를 허용 할 수 있습니다 `[a-zA-Z0-9-_.=]+`.

성공시 : 청크 허용

204 No Content
Location: /v2/<name>/blobs/uploads/<uuid>
Range: 0-<offset>
Content-Length: 0
Docker-Upload-UUID: <uuid>

데이터 덩어리가 수락되었으며 현재 진행률이 범위 헤더에서 사용 가능합니다. 업데이트 된 업로드 위치는Location 헤더 .

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Location`	업로드 위치입니다. 클라이언트는 각 요청 후에 변경 사항을 가정해야합니다. 클라이언트는 업로드를 완료하고 필요한 경우 매개 변수를 추가하기 위해 내용을 축 어적으로 사용해야합니다.
`Range`	업로드의 현재 진행 상태를 나타내는 범위.
`Content-Length`	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.
`Docker-Upload-UUID`	현재 요청에 대한 docker 업로드 uuid를 식별합니다.

실패시 : 잘못된 요청

400 Bad Request
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

업로드를 처리하는 중에 오류가 발생했으며 다시 시작해야합니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DIGEST_INVALID`	제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음	BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`BLOB_UPLOAD_INVALID`	얼룩 업로드 잘못되었습니다.	BLOB 업로드에 오류가 발생하여 더 이상 진행할 수 없습니다.

실패시 : 찾을 수 없음

404 Not Found
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

업로드가 레지스트리에 알려지지 않았습니다. 업로드를 다시 시작해야합니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`BLOB_UPLOAD_UNKNOWN`	레지스트리에 blob 업로드 알 수 없음	BLOB 업로드가 취소되었거나 시작되지 않은 경우이 오류 코드가 반환 될 수 있습니다.

실패시 : 요청 된 범위가 만족스럽지 않음

416 Requested Range Not Satisfiable

그만큼 Content-Range사양은 (는) 현재 진행 상황과 겹치지 않는 하나 때문에, 승인 또는이 잘못 될 수 없습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

PUT BLOB 업로드

에 의해 지정된 업로드를 완료하고 uuid선택적으로 본문을 최종 청크로 추가합니다.

PUT /v2/<name>/blobs/uploads/<uuid>?digest=<digest>
Host: <registry host>
Authorization: <scheme> <token>
Content-Length: <length of data>
Content-Type: application/octet-stream

<binary data>

필요한 경우 본문의 모든 데이터를 제공하여 업로드를 완료하십시오. 본문이없는 요청은 이전에 업로드 한 콘텐츠로 업로드를 완료합니다.

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`Content-Length`	머리글	요청 본문의 길이에 해당하는 업로드되는 데이터의 길이입니다. 데이터가 제공되지 않으면 0이 될 수 있습니다.
`name`	통로	대상 저장소의 이름.
`uuid`	통로	업로드를 식별하는 uuid. 이 필드는 일치하는 문자를 허용 할 수 있습니다 `[a-zA-Z0-9-_.=]+`.
`digest`	질문	업로드 된 BLOB의 다이제스트.

성공시 : 업로드 완료

204 No Content
Location: <blob location>
Content-Range: <start of range>-<end of range, inclusive>
Content-Length: 0
Docker-Content-Digest: <digest>

업로드가 완료되고 레지스트리에서 승인했습니다. 정식 위치는 Location머리글 에서 사용할 수 있습니다 .

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Location`	검색 용 BLOB의 표준 위치
`Content-Range`	본문에 의해 표시되는 원하는 내용 블록을 식별하는 바이트 범위. 시작은 상태 확인을 통해 검색된 오프셋의 끝과 일치해야합니다. 이것은 비표준 `Content-Range`헤더 사용에주의하십시오 .
`Content-Length`	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.
`Docker-Content-Digest`	요청 된 대상 콘텐츠의 요약입니다.

실패시 : 잘못된 요청

400 Bad Request
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

업로드를 처리하는 중에 오류가 발생했으며 다시 시작해야합니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DIGEST_INVALID`	제공된 다이제스트가 업로드 된 콘텐츠와 일치하지 않음	BLOB가 업로드되면 레지스트리는 클라이언트가 제공 한 다이제스트와 내용이 일치하는지 확인합니다. 오류에는 잘못된 다이제스트 문자열을 포함하여 "digest"키가있는 세부 구조가 포함될 수 있습니다. 이 오류는 매니페스트에 잘못된 레이어 다이제스트가 포함되어있는 경우에도 반환 될 수 있습니다.
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`BLOB_UPLOAD_INVALID`	얼룩 업로드 잘못되었습니다.	BLOB 업로드에 오류가 발생하여 더 이상 진행할 수 없습니다.
`UNSUPPORTED`	작업이 지원되지 않습니다.	구현이 누락되었거나 잘못된 매개 변수 집합으로 인해 작업이 지원되지 않았습니다.

실패시 : 찾을 수 없음

404 Not Found
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

업로드가 레지스트리에 알려지지 않았습니다. 업로드를 다시 시작해야합니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`BLOB_UPLOAD_UNKNOWN`	레지스트리에 blob 업로드 알 수 없음	BLOB 업로드가 취소되었거나 시작되지 않은 경우이 오류 코드가 반환 될 수 있습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

BLOB 업로드 삭제

미해결의 업로드 프로세스를 취소하고 관련 자원을 릴리스하십시오. 이것이 호출되지 않으면, 끝나지 않은 업로드가 결국 타임 아웃됩니다.

DELETE /v2/<name>/blobs/uploads/<uuid>
Host: <registry host>
Authorization: <scheme> <token>
Content-Length: 0

에 지정된 업로드를 취소하십시오 uuid.

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`Host`	머리글	표준 HTTP 호스트 헤더. 레지스트리 호스트로 설정해야합니다.
`Authorization`	머리글	RFC7235 호환 승인 헤더.
`Content-Length`	머리글	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.
`name`	통로	대상 저장소의 이름.
`uuid`	통로	업로드를 식별하는 uuid. 이 필드는 일치하는 문자를 허용 할 수 있습니다 `[a-zA-Z0-9-_.=]+`.

성공시 : 업로드 완료

204 No Content
Content-Length: 0

업로드가 성공적으로 삭제되었습니다.

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Content-Length`	`Content-Length`헤더는 0이어야하고, 몸은 비어 있어야합니다.

실패시 : 잘못된 요청

400 Bad Request
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

삭제 처리 중 오류가 발생했습니다. 클라이언트가이 오류를 무시할 수 있습니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_INVALID`	잘못된 저장소 이름	매니페스트 유효성 검사 또는 API 작업 중에 유효하지 않은 저장소 이름이 있습니다.
`BLOB_UPLOAD_INVALID`	얼룩 업로드 잘못되었습니다.	BLOB 업로드에 오류가 발생하여 더 이상 진행할 수 없습니다.

실패시 : 찾을 수 없음

404 Not Found
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

업로드가 레지스트리에 알려지지 않았습니다. 클라이언트는이 오류를 무시하고 업로드가 삭제되었다고 가정합니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`BLOB_UPLOAD_UNKNOWN`	레지스트리에 blob 업로드 알 수 없음	BLOB 업로드가 취소되었거나 시작되지 않은 경우이 오류 코드가 반환 될 수 있습니다.

실패시 : 인증 필요

401 Unauthorized
WWW-Authenticate: <scheme> realm="<realm>", ..."
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 인증되지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`WWW-Authenticate`	RFC7235 호환 인증 챌린지 헤더.
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`UNAUTHORIZED`	인증 필요	액세스 컨트롤러가 클라이언트를 인증 할 수 없습니다. 종종 이것은 인증 방법을 나타내는 Www-Authenticate HTTP 응답 헤더가 수반됩니다.

실패시 : 해당 저장소 오류 없음

404 Not Found
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

저장소가 레지스트리에 알려지지 않았습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`NAME_UNKNOWN`	레지스트리에 알 수없는 저장소 이름	조작 중에 사용 된 이름을 레지스트리에 알려지지 않은 경우 리턴됩니다.

실패시 : 액세스 거부

403 Forbidden
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트는 저장소에 대한 필수 액세스 권한이 없습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`DENIED`	리소스에 대한 요청 된 액세스가 거부되었습니다.	액세스 컨트롤러가 리소스에 대한 작업에 대한 액세스를 거부했습니다.

실패시 : 요청이 너무 많습니다.

429 Too Many Requests
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"errors:" [
	    {
            "code": <error code>,
            "message": "<error message>",
            "detail": ...
        },
        ...
    ]
}

클라이언트가 일정 시간 내에 너무 많은 요청을 보냈습니다.

다음 헤더가 응답에 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

응답 본문에 포함될 수있는 오류 코드는 다음과 같이 열거됩니다.

암호	메시지	기술
`TOOMANYREQUESTS`	너무 많은 요청	클라이언트가 서비스에 너무 자주 접촉하려고 시도 할 때 반환됩니다.

로컬 레지스트리 클러스터에 사용 가능한 저장소 집합을 나열하십시오. 업스트림에서 사용할 수있는 정보를 제공하지 않습니다. 응용 프로그램은 저장소가 사용 가능한지 여부 만 판별 할 수 있지만 사용할 수없는 경우는 판별 할 수 없습니다.

카탈로그를 얻으십시오

레지스트리에서 사용할 수있는 정렬 된 정렬 된 json 목록을 검색하십시오.

카탈로그 가져 오기

GET /v2/_catalog

사용할 수있는 리포지토리 목록을 요청하십시오. 구현시 최대 제한을 적용하고 페이지 매김 링크가 포함 된 부분 집합을 반환 할 수 있습니다.

성공시 : OK

200 OK
Content-Length: <length>
Content-Type: application/json; charset=utf-8

{
	"repositories": [
		<name>,
		...
	]
}

정리되지 않은 리포지토리 목록을 json 응답으로 반환합니다.

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.

카탈로그 가져 오기 매김

GET /v2/_catalog?n=<integer>&last=<integer>

지정된 저장소 부분을 반환합니다.

요청시 다음 매개 변수를 지정해야합니다.

이름	종류	기술
`n`	질문	각 응답의 항목 수를 제한하십시오. 존재하지 않으면 모든 항목이 리턴됩니다.
`last`	질문	결과 집합에는 어휘 적으로 값이 포함됩니다.

성공시 : OK

200 OK
Content-Length: <length>
Link: <<url>?n=<last n value>&last=<last entry from response>>; rel="next"
Content-Type: application/json; charset=utf-8

{
	"repositories": [
		<name>,
		...
	]
	"next": "<url>?last=<name>&n=<last value of n>"
}

다음 헤더가 응답과 함께 반환됩니다.

이름	기술
`Content-Length`	JSON 응답 본문의 길이입니다.
`Link`	RFC5988 준수 rel = 다음 결과 집합에 대한 URL로 'next'(사용 가능한 경우)

[Python] 파일 입출력 모드

SYPER — Tue, 13 Mar 2018 16:41:09 +0900

with open('somefile.txt', 'w+') as f:
    # Note that f has now been truncated to 0 bytes, so you'll only
    # be able to read data that you wrote earlier...
    f.write('somedata\n')
    f.seek(0)  # Important: return to the top of the file before reading, otherwise you'll just read an empty string
    data = f.read() # Returns 'somedata\n'

Note the f.seek(0) -- if you forget this, the f.read() call will try to read from the end of the file, and will return an empty string.

------------------------------------------------------------------------------------------------------------

Actually, there's something wrong about all the other answers about r+ mode.

test.in file's content：

hello1
ok2
byebye3

And the py script's :

with open("test.in", 'r+')as f:
    f.readline()
    f.write("addition")

Execute it and the test.in's content will be changed to :

hello1
ok2
byebye3
addition

However, when we modify the script to :

with open("test.in", 'r+')as f:
    f.write("addition")

the test.in also do the respond:

additionk2
byebye3

So, the r+ mode will allow us to cover the content from the beginning if we did't do the read operation. And if we do some read operation, f.write()will just append to the file.

By the way, if we f.seek(0,0) before f.write(write_content), the write_content will cover them from the positon(0,0).

Here is a list of the different modes of opening a file:

r

Opens a file for reading only. The file pointer is placed at the beginning of the file. This is the default mode.
rb

Opens a file for reading only in binary format. The file pointer is placed at the beginning of the file. This is the default mode.
r+

Opens a file for both reading and writing. The file pointer will be at the beginning of the file.
rb+

Opens a file for both reading and writing in binary format. The file pointer will be at the beginning of the file.
w

Opens a file for writing only. Overwrites the file if the file exists. If the file does not exist, creates a new file for writing.
wb

Opens a file for writing only in binary format. Overwrites the file if the file exists. If the file does not exist, creates a new file for writing.
w+

Opens a file for both writing and reading. Overwrites the existing file if the file exists. If the file does not exist, creates a new file for reading and writing.
wb+

Opens a file for both writing and reading in binary format. Overwrites the existing file if the file exists. If the file does not exist, creates a new file for reading and writing.
a

Opens a file for appending. The file pointer is at the end of the file if the file exists. That is, the file is in the append mode. If the file does not exist, it creates a new file for writing.
ab

Opens a file for appending in binary format. The file pointer is at the end of the file if the file exists. That is, the file is in the append mode. If the file does not exist, it creates a new file for writing.
a+

Opens a file for both appending and reading. The file pointer is at the end of the file if the file exists. The file opens in the append mode. If the file does not exist, it creates a new file for reading and writing.
ab+

Opens a file for both appending and reading in binary format. The file pointer is at the end of the file if the file exists. The file opens in the append mode. If the file does not exist, it creates a new file for reading and writing.

[ELK] ElasticSearch + Kibana + Logstash 설치

SYPER — Sun, 25 Feb 2018 22:39:41 +0900

- Oracle JDK

1. Oracle JDK 다운로드

# wget --no-cookies --no-check-certificate --header "Cookie: gpw_e24=http://www.oracle.com/; oraclelicense=accept-securebackup-cookie" "http://download.oracle.com/otn-pub/java/jdk/8u162-b12/0da788060d494f5095bf8624735fa2f1/jdk-8u162-linux-x64.rpm"

2. Oracle JDK 설치

# yum -y localinstall jdk-8u162-linux-x64.rpm

- ElasticSearch + Kibana + Logstash

1. RPM GPG KEY 임포트

# rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

2. YUM Repo 파일 생성

# echo '[elasticsearch-6.x]

name=Elasticsearch repository for 6.x packages

baseurl=https://artifacts.elastic.co/packages/6.x/yum

gpgcheck=1

gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch

enabled=1

autorefresh=1

type=rpm-md

' | tee /etc/yum.repos.d/elasticsearch.repo

3. ElasticSearch 설치

# yum -y install elasticsearch

4. ElasticSearch 설정

# vi /etc/elasticsearch/elasticsearch.yml

...

#network.host: 192.168.0.1

network.host: localhost

5. ElasticSearch 기동

# systemctl start elasticsearch

# systemctl status elasticsearch

# systemctl enable elasticsearch

6. Kibana 설치

# yum -y install kibana

7. Kibana 설정

# vi /etc/kibana/kibana.yml

...

#server.host: "localhost"

server.host: "0.0.0.0"

8. Kibana 기동

# systemctl start kibana

# systemctl status kibana

# systemctl enable elasticsearch

9. EPEL Release 설치

EPEL 버전은 https://fedoraproject.org/wiki/EPEL에서 확인할 수 있다.

# rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

10. NGINX 설치 (Apache 가능)

# yum -y install nginx httpd-tools

~~# htpasswd -c /etc/nginx/htpasswd.users admin~~

11. NGINX 설정

# cat /etc/nginx/conf.d/kibana.conf

server {

listen 8080;

listen [::]:8080;

server_name _;

location / {

~~auth_basic "Restricted Access";~~

~~auth_basic_user_file /etc/nginx/htpasswd.users;~~

proxy_set_header X-Forwarded-Host $host;

proxy_set_header X-Forwarded-Server $host;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_pass http://localhost:5601;

}

# cat /etc/nginx/nginx.conf

...

include /etc/nginx/conf.d/*.conf;

# systemctl start nginx && systemctl enable nginx

------------------------------------------------------------------------------

※ x-pack 설치 (skip)

# cd /usr/share/elasticsearch # base elasticsearch install directory

# bin/elasticsearch-plugin install x-pack

# bin/x-pack/setup-passwords interactive

-> 패스워드 설정

# systemctl restart elasticsearch

# bin/kibana-plugin install x-pack # base kibana install directory

# vi /etc/kibana/kibana.yml # Add credentials to the kibana.yml file

elasticsearch.username: "kibana"

elasticsearch.password: "<pwd>"

# systemctl restart kibana

------------------------------------------------------------------------------

12. Logstash 설치

# yum -y install logstash

13. (Logstash) SSL 설정 (Optional)

# cd /etc/pki/tls

# cat /etc/pki/tls/openssl.conf

...

subjectAltName = IP:172.30.1.11 # ELK_server_private_ip

...

# openssl req -config /etc/pki/tls/openssl.cnf -x509 -days 3650 -batch -nodes -newkey rsa:2048 \

-keyout private/logstash-forwarder.key -out certs/logstash-forwarder.crt

이후에 위 logstash-forwarder.crt 파일은 Logstash 서버에 로그를 보내는 모든 서버들에 카피가 되어야 한다.

14. Logstash 설정

# vi /etc/logstash/conf.d/02-beats-input.conf

input { beats { port => 5044 ssl => true ssl_certificate => "/etc/pki/tls/certs/logstash-forwarder.crt" ssl_key => "/etc/pki/tls/private/logstash-forwarder.key" } }

# vi /etc/logstash/conf.d/10-syslog-filter.conf

filter { if [type] == "syslog" { grok { match => { "message" => "%{SYSLOGTIMESTAMP:syslog_timestamp} %{SYSLOGHOST:syslog_hostname} %{DATA:syslog_program}\:%{SPACE}%{GREEDYDATA:syslog_message}" } add_field => [ "received_at", "%{@timestamp}" ] add_field => [ "received_from", "%{host}" ] } syslog_pri { } date { match => [ "syslog_timestamp", "MMM d HH:mm:ss", "MMM dd HH:mm:ss" ] } } }

# /etc/logstash/conf.d/30-elasticsearch-output.conf

output {

elasticsearch { hosts => ["localhost:9200"] sniffing => true manage_template => false index => "%{[@metadata][beat]}-%{+YYYY.MM.dd}" document_type => "%{[@metadata][type]}" } }

# systemctl restart logstash

# systemctl enable logstash

15. Beats-Dashboard 설치

# cd /tmp

# curl -L -O http://download.elastic.co/beats/dashboards/beats-dashboards-1.3.1.zip

# unzip beats-dashboards-1.3.1.zip

# cd beats-dashboards-*

# ./load.sh -url "http://localhost:9200" -user "admin:secret" # x-pack 설치 시 kibana:암호

16. Filebeat 설치

# yum -y install filebeat

# vi /etc/filebeat/filebeat.yml

filebeat.prospectors:

- type: log

paths:

- /var/log/messages - /var/log/secure #- /var/log/*.log

...

#output.logstash:

# The Logstash hosts

#hosts: ["localhost:5044"]

hosts: ["172.30.1.12:5044"] # ELK_server_private_IP

bulk_max_size: 1024 # 로그 버퍼 최대 사이즈 옵션? 확인 필요

# Optional SSL. By default is off.

# List of root certificates for HTTPS server verifications

#ssl.certificate_authorities: ["/etc/pki/root/ca.pem"]

ssl.certificate_authorities: ["/etc/pki/tls/certs/logstash-forwarder.crt"]

# systemctl start filebeat

# systemctl enable filebeat

curl -XGET 'http://localhost:9200/filebeat-*/_search?pretty'

curl --user "kibana:rain2bow" -XGET 'http://localhost:9200/filebeat-*/_search?pretty'

[JAVA] 리눅스에서 오라클 Java를 wget으로 다운로드 하는 방법

SYPER — Sun, 25 Feb 2018 18:31:55 +0900

리눅스에서 wget 커맨드를 이용하여, Oracle JDK를 받는 방법이다.

http://www.oracle.com/technetwork/java/javase/downloads/

위 웹 사이트에서 다운로드 하고자 하는 버전을 확인, 선택 후에

"Accept License Agreement "하면 해당 패키지의 URL을 확인할 수 있다.

해당 URL을 복사하여, wget으로 받으면 된다.

아래와 같은 옵션을 사용하면 된다.

wget --no-cookies --no-check-certificate --header "Cookie: gpw_e24=http://www.oracle.com/; oraclelicense=accept-securebackup-cookie" "http://download.oracle.com/otn-pub/java/jdk/8u162-b12/0da788060d494f5095bf8624735fa2f1/jdk-8u162-linux-x64.rpm"

Docker 이미지 사이즈 조정

SYPER — Wed, 19 Apr 2017 09:16:18 +0900

docker run 실행 시 --storage-opt size=OOG로 하여 rootfs의 사이즈를 조정할 수 있다.

-------------------------------------------------------------------------------------------------------------------

아래는 이미 run한 상태의 docker 이미지의 사이즈를 조정하는 방법

기본적으로 Docker 이미지에는 10G의 공간이 할당되는데, 이 영역을 조정해야 하는 경우가 있다.

우선 Docker 이미지를 다운로드하거나 build한 후에 docker run 명령을 통해 해당 컨테이너를 실행한다.

그리고 나서 /dev/mapper 경로로 이동하여, ls -l 명령으로 정보를 보면 아래와 같이

방금 실행한 컨테이너의 디바이스 정보가 생성되어 있다.

# ls -l /dev/mapper

.... docker-253:9-33555456-b52e89c883463c78dba60b705eb431cd30fbb3de23703528df413452e6e39158 -> ../dm-12

그러면 다음과 같은 명령으로 device-mapper 테이블에서 해당 디바이스의 정보를 확인한다

# dmsetup table docker-253:9-33555456-b52e89c883463c78dba60b705eb431cd30fbb3de23703528df413452e6e39158

0 20971520 thin 253:11 42

여기서 20971520 값은 10G를 512Byte로 표현한 값이다.

그 값을 실제 증설하고자 하는 크기로 변경해야 하며, 아래와 같은 방식으로 입력하면 된다.

# echo 0 31457280 thin 253:11 42 | dmsetup load docker-253:9-33555456-b52e89c883463c78dba60b705eb431cd30fbb3de23703528df413452e6e39158

# dmsetup table docker-253:9-33555456-b52e89c883463c78dba60b705eb431cd30fbb3de23703528df413452e6e39158 // 확인

# dmsetup resume docker-253:9-33555456-b52e89c883463c78dba60b705eb431cd30fbb3de23703528df413452e6e39158

마지막으로 디바이스의 정보를 갱신한 후, 해당 디바이스의 FS를 늘려주는 작업을 진행해야 한다

# resize2fs docker-253:9-33555456-b52e89c883463c78dba60b705eb431cd30fbb3de23703528df413452e6e39158 // RHEL 6

# xfs_growfs docker-253\:9-33555456-b52e89c883463c78dba60b705eb431cd30fbb3de23703528df413452e6e39158 // RHEL 7

단, 아래와 같이 docker 이미지를 저장해도, 해당 docker 이미지는 종료 후 다시 로드하면 초기화된다.

# docker commit f6cf11f6ca65 base/centos7:cuda8.0-cudnn5

[RHEL] RHEL 네트워크 설정 파일 파라미터 설명

SYPER — Sun, 26 Mar 2017 17:11:54 +0900

다음 설정 파라미터들은 일반적으로 인터페이스 설정 파일에 사용된다.

BOOTPROTO

인터페이스가 IP 어드레스를 얻는 방식:

bootp: Bootstrap Protocol (BOOTP).
dhcp: Dynamic Host Configuration Protocol (DHCP).
none: Statically configured IP address.

BROADCAST

IPv4 broadcast address.

DEFROUTE

이 인터페이스가 default route인지 여부

DEVICE

Name of the physical network interface device (or a PPP logical device).

HWADDR

Media access control (MAC) address of an Ethernet device.

IPADDR

IPv4 address of the interface.

IPV4_FAILURE_FATAL

IPv4 설정이 실패할 때 그 장치를 비활성화할 지 여부

IPV6_FAILURE_FATAL

IPv6 설정이 실패할 때 그 장치를 비활성화할 지 여부

IPV6ADDR

IPv6 address of the interface in CIDR notation. For example: IPV6ADDR="2001:db8:1e11:115b::1/32"

IPV6INIT

인터페이스의 IPv6를 활성화할 지 여부

MASTER

Specifies the name of the master bonded interface, of which this interface is slave.

NAME

Name of the interface as displayed in the Network Connections GUI.

NETMASK

IPv4 network mask of the interface.

NETWORK

IPV4 address of the network.

NM_CONTROLLED

네트워크 인터페이스 장치가 NetworkManager, 네트워크 관리 데몬인 NetworkManager로 부터 컨트롤 될지의 여부

ONBOOT

Whether the interface is activated at boot time.

PEERDNS

DNS resolution에 사용되는 /etc/resolv.conf 파일이 DHCP 서버로 부터 정보를 얻는 것을 허용할 지 여부

PEERROUTES

이 인터페이스에 대한 default gateway를 정의하는 라우팅테이블 정보를 DHCP 서버로 부터 얻을지 여부

SLAVE

Specifies that this interface is a component of a bonded interface.

TYPE

인터페이스 타입.

USERCTL

root가 아닌 사용자가 인터페이스의 상태를 컨트롤 할 수 있는 지 여부

UUID

네트워크 인터페이스에 대한 유니크한 ID 값

-----------------------------------------------------------------------------------------------------------------------------------------------------------------

⁠11.2. Interface Configuration Files

Interface configuration files control the software interfaces for individual network devices. As the system boots, it uses these files to determine what interfaces to bring up and how to configure them. These files are usually named ifcfg-name, where name refers to the name of the device that the configuration file controls.

⁠11.2.1. Ethernet Interfaces

One of the most common interface files is /etc/sysconfig/network-scripts/ifcfg-eth0, which controls the first Ethernet network interface card or NIC in the system. In a system with multiple NICs, there are multiple ifcfg-ethX files (where X is a unique number corresponding to a specific interface). Because each device has its own configuration file, an administrator can control how each interface functions individually.

The following is a sample ifcfg-eth0 file for a system using a fixed IP address:

DEVICE=eth0
BOOTPROTO=none
ONBOOT=yes
NETMASK=255.255.255.0
IPADDR=10.0.1.27
USERCTL=no

The values required in an interface configuration file can change based on other values. For example, the ifcfg-eth0 file for an interface using DHCP looks different because IP information is provided by the DHCP server:

DEVICE=eth0
BOOTPROTO=dhcp
ONBOOT=yes

NetworkManager is graphical configuration tool which provides an easy way to make changes to the various network interface configuration files (see Chapter 10, NetworkManager for detailed instructions on using this tool).

However, it is also possible to manually edit the configuration files for a given network interface.

Below is a listing of the configurable parameters in an Ethernet interface configuration file:

BONDING_OPTS=parameters

sets the configuration parameters for the bonding device, and is used in /etc/sysconfig/network-scripts/ifcfg-bondN (see Section 11.2.4, “Channel Bonding Interfaces”). These parameters are identical to those used for bonding devices in /sys/class/net/bonding_device/bonding, and the module parameters for the bonding driver as described in bonding Module Directives.

This configuration method is used so that multiple bonding devices can have different configurations. In Red Hat Enterprise Linux 6, place all interface-specific bonding options after the BONDING_OPTS directive in ifcfg-name files. See Where to specify bonding module parameters for more information.

BOOTPROTO=protocol

none — No boot-time protocol should be used.
bootp — The BOOTP protocol should be used.
dhcp — The DHCP protocol should be used.

BROADCAST=address

where address is the broadcast address. This directive is deprecated, as the value is calculated automatically with ipcalc.

DEVICE=name

where name is the name of the physical device (except for dynamically-allocated PPP devices where it is the logical name).

DHCP_HOSTNAME=name

name 은 DHCP 서버로 보내지는 짧은 호스트네임. IP주소를 받기 전에 DHCP서버가 클라이언트가 호스트네임을 요구하는 경우에 사용.

DHCPV6C=answer

yes — 이 인터페이스에 대한 IPv6 주소를 얻기 위해 DHCP를 사용한다.
no — 이 인터페이스에 대한 IPv6 주소를 얻기 위해 DHCP를 사용하지 않는다. 기본 값

IPv6 link-local 주소는 기본적으로 할당될 것이다. link-local 주소는 인터페이스의 MAC address에 기반한다

DHCPV6C_OPTIONS=answer

-P — Enable IPv6 prefix delegation.
-S — Use DHCP to obtain stateless configuration only, not addresses, for this interface.
-N — Restore normal operation after using the -T or -P options.
-T — Use DHCP to obtain a temporary IPv6 address for this interface.
-D — Override the default when selecting the type of DHCP Unique Identifier (DUID) to use.
By default, the DHCP client (dhclient) creates a DHCP Unique Identifier (DUID) based on the link-layer address (DUID-LL) if it is running in stateless mode (with the -S option, to not request an address), or it creates an identifier based on the link-layer address plus a timestamp (DUID-LLT) if it is running in stateful mode (without -S, requesting an address). The -D option overrides this default, with a value of either LL or LLT.

DNS{1,2}=address

PEERDNS 지시자가 no로 설정되지 않는다면, address 는 /etc/resolv.conf에 적힌 네임 서버 주소이다.

ETHTOOL_OPTS=options

where options are any device-specific options supported by ethtool. For example, if you wanted to force 100Mb, full duplex:

ETHTOOL_OPTS="autoneg off speed 100 duplex full"

Instead of a custom initscript, use ETHTOOL_OPTS to set the interface speed and duplex settings. Custom initscripts run outside of the network init script lead to unpredictable results during a post-boot network service restart.

Set “autoneg off” before changing speed or duplex settings

Changing speed or duplex settings almost always requires disabling auto-negotiation with the autoneg off option. This option needs to be stated first, as the option entries are order-dependent.

See Section 11.8, “Ethtool” for more ethtool options.

HOTPLUG=answer

yes — 이 장치가 hot-plugged 될 때, activate되어야 한다. (기본 값)
no — 이 장치가 hot-plugged 될 때, activate되지 않는다.

The HOTPLUG=no option can be used to prevent a channel bonding interface from being activated when a bonding kernel module is loaded.

See Section 11.2.4, “Channel Bonding Interfaces” for more information about channel bonding interfaces.

HWADDR=MAC-address

where MAC-address is the hardware address of the Ethernet device in the form AA:BB:CC:DD:EE:FF. This directive must be used in machines containing more than one NIC to ensure that the interfaces are assigned the correct device names regardless of the configured load order for each NIC's module. This directive should not be used in conjunction with MACADDR.

Note

Persistent device names are now handled by /etc/udev/rules.d/70-persistent-net.rules.
HWADDR must not be used with System z network devices.
See Section 25.3.3, "Mapping subchannels and network device names", in the Red Hat Enterprise Linux 6 Installation Guide.

IPADDRn=address

address 는 IPv4 주소이며, n 은 0부터 시작하는 연속적인 양의 정수이어야 한다. (예를 들면, IPADDR0). 인터페이스에 여러개의 IP 주소를 설정하는 데 사용된다. 하나의 주소만 설정되는 경우에는 삭제될 수 있다.

IPV6ADDR=address

where address is the first static, or primary, IPv6 address on an interface.

The format is Address/Prefix-length. If no prefix length is specified, /64 is assumed. Note that this setting depends on IPV6INIT being enabled.

IPV6ADDR_SECONDARIES=address

where address is one or more, space separated, additional IPv6 addresses.

The format is Address/Prefix-length. If no prefix length is specified, /64 is assumed. Note that this setting depends on IPV6INIT being enabled.

IPV6INIT=answer

yes — IPv6 addressing하도록 이 인터페이스를 초기화한다.
no — IPv6 addressing 하도록 이 인터페이스를 초기화하지 않는다. 기본 값
이 설정은 IPv6 static과 IPv6 addresses의 DHCP 할당을 위해 필요하다. IPv6 Stateless Address Autoconfiguration (SLAAC)에 영향을 주지 않는다.
See Section D.1.13, “/etc/sysconfig/network” for information on disabling IPv6.

IPV6_AUTOCONF=answer

yes — 이 인터페이스에 대해 IPv6 autoconf 설정을 enable 한다.
no — 이 인터페이스에 대해 IPv6 autoconf 설정을 disable 한다.

enable되면, IPv6 어드레스는 radvd 데몬을 구동하는 라우터로 부터 ND(Neighbor Discovery)를 사용하여 요청된다..

IPV6_AUTOCONF의 기본 값은 다음과 같이 IPV6FORWARDING에 따라 달라진다는 것을 주의해라:

If IPV6FORWARDING=yes, then IPV6_AUTOCONF will default to no.
If IPV6FORWARDING=no, then IPV6_AUTOCONF will default to yes and IPV6_ROUTER has no effect.

IPV6_MTU=value

where value is an optional dedicated MTU for this interface.

IPV6_PRIVACY=rfc3041

where rfc3041 optionally sets this interface to support RFC 3041 Privacy Extensions for Stateless Address Autoconfiguration in IPv6. Note that this setting depends on IPV6INIT option being enabled.

The default is for RFC 3041 support to be disabled. Stateless Autoconfiguration will derive addresses based on the MAC address, when available, using the modified EUI-64 method. The address is appended to a prefix but as the address is normally derived from the MAC address it is globally unique even when the prefix changes. In the case of a link-local address the prefix is fe80::/64 as per RFC 2462 IPv6 Stateless Address Autoconfiguration.

LINKDELAY=time

장치를 설정하기 전에 링크 negotiation에 대기하는 시간(초). 기본 값은 5초이다. 링크 negotiation에서의 지연, 예를 들어 STP에 의해 발생하는 지연은 이 값을 증가시켜 해결할 수 있다.

MACADDR=MAC-address

where MAC-address is the hardware address of the Ethernet device in the form AA:BB:CC:DD:EE:FF.

This directive is used to assign a MAC address to an interface, overriding the one assigned to the physical NIC. This directive should not be used in conjunction with the HWADDR directive.

MASTER=bond-interface

where bond-interface is the channel bonding interface to which the Ethernet interface is linked.

This directive is used in conjunction with the SLAVE directive.

See Section 11.2.4, “Channel Bonding Interfaces” for more information about channel bonding interfaces.

NETMASKn=mask

where mask is the netmask value and the n is expected to be consecutive positive integers starting from 0 (for example, NETMASK0). It is used for configurations with multiple IP addresses on an interface. It can be omitted if there is only one address being configured.

NETWORK=address

where address is the network address. This directive is deprecated, as the value is calculated automatically with ipcalc.

NM_CONTROLLED=answer

yes — 이 장치를 설정하도록 NetworkManager를 허용. 이 것은 기본 동작이며, 생략 가능.
no — 이 장치를 설정하도록 NetworkManager를 허용하지 않음.

Note

The NM_CONTROLLED directive is now, as of Red Hat Enterprise Linux 6.3, dependent on the NM_BOND_VLAN_ENABLED directive in /etc/sysconfig/network. If and only if that directive is present and is one of yes, y, or true, will NetworkManager detect and manage bonding and VLAN interfaces.

ONBOOT=answer

yes — This device should be activated at boot-time.
no — This device should not be activated at boot-time.

PEERDNS=answer

yes — 만일 DNS 지시자가 설정되고, DHCP를 사용하면 /etc/resolv.conf를 수정한다. 모든 경우에 yes가 기본 값
no — /etc/resolv.conf를 수정하지 않는다.

SLAVE=answer

yes — This device is controlled by the channel bonding interface specified in the MASTER directive.
no — This device is not controlled by the channel bonding interface specified in the MASTER directive.

This directive is used in conjunction with the MASTER directive.

See Section 11.2.4, “Channel Bonding Interfaces” for more about channel bonding interfaces.

SRCADDR=address

where address is the specified source IP address for outgoing packets.

USERCTL=answer

yes — Non-root users are allowed to control this device.
no — Non-root users are not allowed to control this device.

TOP GUN

Ed Sheeran - Even my dad does sometimes

GETOPTS

고품질의 무료 PPT 템플릿 사이트 추천

Windows 파일공유(SMB) 대체를 위한 SSHFS

[Docker] Docker Registry HTTP API V2

HTTP API V2

Estimated reading time: 127 minutes

Docker Registry HTTP API V2

Introduction

Scope

FUTURE

Use Cases

대부분의 경우 이전 레지스트리 API의 사용 사례가 새 버전에 적용됩니다. 차별화 된 사용 사례는 아래에서 다룹니다.

IMAGE VERIFICATION

RESUMABLE PUSH

RESUMABLE PULL

LAYER UPLOAD DE-DUPLICATION

프로세스 A와 B가 같은 레이어를 동시에 업로드하면 두 작업이 모두 진행되고 완료된 첫 번째 작업이 레지스트리에 저장됩니다 (참고 : 일부 잠금 메커니즘이있는 닥치는 것을 방지하기 위해이 작업을 수정할 수 있습니다).

Overview

Errors

Content Digests

다이제스트 헤더

Pulling An Image

"이미지"는 JSON 매니페스트와 개별 레이어 파일의 조합입니다. 이미지를 가져 오는 프로세스는이 두 구성 요소를 검색하는 것을 중심으로합니다.

이미지 매니페스트 가져 오기

기존 매니페스트

레이어 당기기

Pushing An Image

프로세스의 각 단계에 대한 자세한 내용은 다음 절에서 다룹니다.

레이어 밀기

업로드 시작

프로세스를 시작하려면 POST 요청을 다음 형식으로 실행해야합니다.POST /v2/<name>/blobs/uploads/ 이 요청의 매개 변수는 레이어가 링크 될 이미지 네임 스페이스입니다. 이 요청에 대한 응답은 아래에서 다룹니다.

기존 레이어

레이어 업로드

업로드 진행

모 놀리 식 업로드

청크 업로드

완료된 업로드

다이제스트 매개 변수

업로드 취소

교차 저장소 브 로브 마운트

오류

Deleting a Layer

해당 name및을 통해 레지스트리에서 레이어를 삭제할 수 있습니다 digest. 삭제 요청은 다음 요청 형식으로 발행 될 수 있습니다.

이미지 매니페스트 푸시

Listing Repositories

쪽수 매기기

Listing Image Tags

주어진 저장소 아래에 모든 태그를 나열해야 할 수도 있습니다. 이미지 저장소의 태그는 다음 요청으로 검색 할 수 있습니다.

쪽수 매기기

Deleting an Image

Detail

오류

베이스

기본 V2 API 경로. 일반적으로이 기능은 경량 버전 확인 및 레지스트리 인증의 유효성 검사에 사용할 수 있습니다.

GET BASE

성공시 : OK

200 OK API는 V2 프로토콜을 구현하며 액세스 할 수 있습니다.

실패시 : 찾을 수 없음

404 Not Found 레지스트리는 V2 API를 구현하지 않습니다.

실패시 : 인증 필요

실패시 : 요청이 너무 많습니다.

태그

태그에 대한 정보를 검색하십시오.

GET 태그

에 의해 식별 된 저장소 아래에 태그를 가져옵니다 name.

태그

성공시 : OK

200 OK Content-Length: <length> Content-Type: application/json; charset=utf-8 { "name": <name>, "tags": [ <tag>, ... ] } 명명 된 저장소의 태그 목록입니다.다음 헤더가 응답과 함께 반환됩니다.이름기술Content-LengthJSON 응답 본문의 길이입니다.

실패시 : 인증 필요

실패시 : 해당 저장소 오류 없음

실패시 : 액세스 거부

실패시 : 요청이 너무 많습니다.

태그가 지정된 태그

성공시 : OK

실패시 : 인증 필요

실패시 : 해당 저장소 오류 없음

실패시 : 액세스 거부

실패시 : 요청이 너무 많습니다.

프로세스를 시작하려면 POST 요청을 다음 형식으로 실행해야합니다.
`POST /v2/<name>/blobs/uploads/`
이 요청의 매개 변수는 레이어가 링크 될 이미지 네임 스페이스입니다. 이 요청에 대한 응답은 아래에서 다룹니다.

해당 `name`및을 통해 레지스트리에서 레이어를 삭제할 수 있습니다 `digest`. 삭제 요청은 다음 요청 형식으로 발행 될 수 있습니다.

`200 OK`
API는 V2 프로토콜을 구현하며 액세스 할 수 있습니다.

`404 Not Found`
레지스트리는 V2 API를 구현하지 않습니다.

에 의해 식별 된 저장소 아래에 태그를 가져옵니다 `name`.

`200 OK Content-Length: <length> Content-Type: application/json; charset=utf-8 { "name": <name>, "tags": [ <tag>, ... ] }`
명명 된 저장소의 태그 목록입니다.
다음 헤더가 응답과 함께 반환됩니다.
이름 기술
`Content-Length` JSON 응답 본문의 길이입니다.