COS(Cloud Object Storage) 콘솔에서 버킷에 대한 Origin-pull 규칙을 구성할 수 있습니다. 요청한 객체가 버킷에 없거나 특정 요청을 리디렉션해야 하는 경우 COS를 통해 해당 데이터에 액세스하도록 Origin-pull 규칙을 구성할 수 있습니다. Origin-pull 구성은 주로 핫 데이터 마이그레이션, 특정 요청 리디렉션 및 기타 관련 시나리오에 사용됩니다. 귀하의 실제 필요에 따라 설정할 수 있습니다.
설명：
Origin-pull에 의한 데이터 풀링 성공률은 네트워크 환경과 관련이 있습니다. China Telecom, China Mobile, China Unicom 등의 IP를 우선적으로 사용하십시오.
금융 클라우드 리전의 버킷은 origin-pull 설정을 지원하지 않습니다.
퍼블릭 클라우드 리전 중 일부 리전만 동기 origin-pull을 지원합니다. 지원 리전: 베이징, 청두, 광저우, 난징, 상하이, 홍콩, 싱가포르, 자카르타, 서울, 방콕, 도쿄, 리야드, 실리콘밸리(미국 서부), 버지니아(미국 동부), 상파울루, 프랑크푸르트.
Origin-pull 규칙
트리거 조건
비동기 및 동기화 origin-pull 모드에서 origin-pull은,GET 요청에서 404가 반환된 경우에만 origin-pull이 트리거됩니다. HEAD 또는 기타 요청은 origin-pull을 트리거하지 않습니다.
리디렉션 모드에서 400~599 사이의 HTTP 상태 코드를 사용자 지정하여 origin-pull을 트리거할 수 있습니다.
원본 액세스
비동기화 및 동기화 origin-pull 모드에서 COS 액세스 요청의 QueryString 및 Header 정보를 원본에 전달할지 여부를 설정하고, 원본 요청 시 추가 Header 정보를 전달하도록 구성할 수 있습니다. 리디렉션 모드에서는 QueryString 통과 여부만 설정할 수 있습니다.
GET 연산 중에 GET range가 지정되면 COS는 완전한 객체 데이터를 가져와 COS에 저장하기 위해 원래 요청 외에 range가 없는 비동기 요청을 보냅니다.
응답 및 저장
원본은 chunked 인코딩으로 데이터를 반환할 수 있습니다.
원본이 404 상태 코드를 반환하면 COS로 전달되어 사용자에게 반환됩니다. 3XX 팔로우 정책이 활성화된 경우 원본이 3XX 상태 코드를 반환하면 COS는 다른 원본에서 데이터를 가져옵니다. 원본이 3XX가 아닌 다른 상태 코드를 반환하면 COS는 424 상태 코드를 반환합니다.
origin-pull에 의해 반환된 파일은 원본 요청 시 사용한 파일명으로 COS에 저장됩니다. 예를 들어 사용자가 요청한 example.jpg 파일이 버킷에 존재하지 않는 경우, COS는 구성된 origin-pull 주소 http://origin.com/example.jpg에서 파일을 풀링하고 example.jpg 버킷에 저장된 파일의 이름을 바꾸는 origin-pull 메커니즘을 트리거합니다.
COS에 저장된 새 객체에는 다음 메타데이터가 포함되며 데이터 콘텐츠는 원본 값을 따릅니다.
4. 왼쪽 사이드바에서 기본 설정 > Origin-pull 설정을 선택하고 Origin-pull 규칙 추가를 클릭합니다.
5. 팝업 창에서 다음 정보를 설정하고 다음 단계를 클릭합니다.
Origin-pull 모드: Origin-pull 모드는 실제 필요에 따라 선택할 수 있습니다.
Origin-pull 비동기화: 요청된 파일이 COS에 없으면 COS는 지정된 원본에서 파일을 찾아 클라이언트로 반환하지 않고 버킷에 업로드합니다.
설명：
비동기식 Origin-pull은 파일을 직접 반환하지 않습니다. 대신 먼저 클라이언트에 302 상태 코드를 반환한 다음 파일을 COS에 비동기식으로 업로드합니다.
원본에서 데이터를 가져오려면 Follow 302를 활성화하는 것이 좋습니다.
파일 업로드 시간은 여러 요인에 따라 달라지며 SLA는 약속할 수 없습니다. 비즈니스가 지연에 민감한 경우 Origin-pull 동기화를 선택하는 것이 좋습니다.
Origin-pull 동기화: 요청한 파일이 COS에 없는 경우, COS는 지정된 원본에서 파일을 검색하여 클라이언트에 반환하고 버킷에 업로드합니다.
주의:
동기 origin-pull을 사용할 때, 전체 파일이 다운로드되고 상태 코드 200이 반환된 경우에만 적시성을 보장할 수 있습니다. 클라이언트가 range 요청으로 파일에 접근하는 경우에는 적시성을 보장할 수 없습니다.
리디렉션: 버킷에 액세스할 때 지정된 오류가 보고되면 COS는 클라이언트에 리디렉션 주소를 반환하지만 원본에서 파일을 저장하지 않습니다. 클라이언트는 리디렉션 주소의 원본에서 리소스를 요청할 수 있습니다.
Origin-pull 조건: Origin-Pull을 트리거하기 위해 동시에 충족되어야 하는 모든 조건을 지정합니다.
HTTP 상태 코드 404: 비동기화 Origin-pull 또는 동기화 Origin-pull을 선택하는 GET 요청에서 HTTP 상태 코드 404를 반환할 때 origin-pull이 트리거됩니다. 이 항목은 필수이며 비활성화할 수 없습니다.리디렉션을 선택하면 400~599 범위의 HTTP 상태 코드를 입력할 수 있습니다.
파일명 접두사: 요청된 파일이 접두사와 일치하면 origin-pull 규칙이 트리거됩니다. 파일명 접두사를 prefix로 설정한 경우, GET를 통해 https://examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/prefix123.jpg 요청하고 HTTP 상태 코드 404를 반환할 때 origin-pull 규칙이 트리거됩니다.
Origin-pull 프로토콜: COS가 지정된 원본에 액세스하는 데 사용하는 프로토콜입니다. 옵션에는 Force HTTPS, Force HTTP 및 Follow 요청 프로토콜이 포함됩니다.
Force HTTPS 또는 Force HTTP를 선택할 경우, COS는 각각 HTTPS 또는 HTTP를 사용하여 원본에 액세스합니다.
Follow 요청 프로토콜을 선택할 경우, COS는 요청에 사용된 프로토콜로 원본에 액세스합니다.
요청 매개변수: COS에 액세스할 때 가지고 다니는 queryString 요청 매개변수를 원본으로 전달할지 여부를 지정합니다.
요청 헤더: 모든 요청 헤더를 전달하거나 특정 요청 헤더만 전달하는 옵션이 있습니다. 모든 요청 헤더를 전달하는 경우 host 헤더는 전달 금지를 권장하며, 원클릭 설정이 지원됩니다.
특정 요청 헤더 전달: 특정 요청 헤더 전달 옵션을 선택하면, 원본 서버에 전달할 요청 헤더를 지정해야 합니다. 리디렉션 선택 시 설정할 필요가 없습니다.
특정 요청 헤더 전달금지: 원본 서버에 전달하지 않을 요청 헤더를 지정할 수 있습니다. 리디렉션 선택 시 설정할 필요가 없습니다.
요청 헤더 추가: 원본 서버로 돌아갈 때 추가 요청 헤더를 여기에서 추가할 수 있습니다. 원본으로 리디렉션 유형을 선택하면 이 항목은 설정하지 않아야 합니다.
6. 선택한 Origin-pull 모드에 따라 다음 정보를 구성하도록 선택하고 다음 단계를 클릭합니다.
Origin-pull 비동기화
Origin-pull 동기화
리디렉션
Origin-pull 주소: http:// 또는 https:// 접두사 없이 도메인 이름 또는 IP 주소를 입력합니다. 도메인 이름이나 IP 주소 뒤에 포트 번호를 추가할 수도 있습니다.
정확한 주소의 예시는 다음과 같습니다.
abc.example.com
abc.example.com:8080
202.96.128.86
202.96.128.86:8080
대기 포워딩 주소: 백업 origin-pull 주소 설정을 지원합니다. 입력 형식은 Origin-pull 주소 설정 항목 설명을 참고하십시오. 이 설정은 버킷이 위치한 리전에 따라 다르며, 지원되는 경우에만 설정할 수 있습니다.
주소 설정: 특정 파일 또는 경로 설정 여부를 선택할 수 있습니다. 설정 항목 설명은 다음과 같습니다.
고정 파일설정: Origin-pull 규칙이 트리거되면 모두 고정 파일로 이동됩니다.
접두사및접미사설정: Origin-pull 규칙이 트리거될 경우, 지정한 접두사 또는 접미사가 포함된 파일 경로로 이동합니다.
예를 들어 접두사를 test로 지정하고 https://examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/path/prefix123.jpg 접근 시 origin-pull 규칙이 트리거되면 <origin address>/test/path/prefix123.jpg 로 이동합니다.
또한 접미사를 .jpg로 지정하고 https://examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/path/prefix123 접근 시 origin-pull 규칙이 트리거되면 <origin address>/path/prefix123.jpg 로 이동합니다.
주의:
지정한 접두사와 접미사 설정은 동시에 적용할 수 있습니다.
3XX 따라가기 정책: 활성화 시, 원본 서버가 3XX 리디렉션 상태 코드를 반환할 경우 COS는 기본적으로 3XX를 따라가 다른 원본 서버에서 데이터를 가져옵니다. 비활성화를 선택하면 리소스를 가져오지 않습니다.
주의:
원본 서버가 반환한 3XX 리디렉션이 사설망 주소로 이동하는 경우, COS는 이를 따르지 않습니다. 동기 origin-pull 모드에서는 COS가 사설망 주소로의 리디렉션을 따르지 않으며, 비동기 및 리디렉션 모드에서는 사설망 주소 반환 후 업무 로직에 따라 따를지 여부를 판단해야 합니다.
Origin-pull 주소: http:// 또는 https:// 접두사 없이 도메인 이름 또는 IP 주소를 입력합니다. 도메인 이름이나 IP 주소 뒤에 포트 번호를 추가할 수도 있습니다.
정확한 주소의 예시는 다음과 같습니다.
abc.example.com
abc.example.com:8080
202.96.128.86
202.96.128.86:8080
대기 포워딩 주소: 백업 origin-pull 주소 설정을 지원합니다. 입력 형식은 Origin-pull 주소 설정 항목 설명을 참고하십시오. 이 설정은 버킷이 위치한 리전에 따라 다르며, 지원되는 경우에만 설정할 수 있습니다.
주소 설정: 특정 파일 또는 경로 설정 여부를 선택할 수 있습니다. 설정 항목 설명은 다음과 같습니다.
고정 파일설정: Origin-pull 규칙이 트리거되면 모두 고정 파일로 이동됩니다.
접두사및접미사설정: Origin-pull 규칙이 트리거될 경우, 지정한 접두사 또는 접미사가 포함된 파일 경로로 이동합니다.
예를 들어 접두사를 test로 지정하고 https://examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/path/prefix123.jpg 접근 시 origin-pull 규칙이 트리거되면 <origin address>/test/path/prefix123.jpg 로 이동합니다.
또한 접미사를 .jpg로 지정하고 https://examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/path/prefix123 접근 시 origin-pull 규칙이 트리거되면 <origin address>/path/prefix123.jpg 로 이동합니다.
주의:
지정한 접두사와 접미사 설정은 동시에 적용할 수 있습니다.
3XX 종속 정책: 이 정책이 활성화된 경우 원본이 3xx 리디렉션을 반환하면 COS가 이를 따라 다른 원본에서 데이터를 가져옵니다. 비활성화를 선택하면 리소스를 풀링하지 않습니다.
원본 사이트의 패킷: 이 기능이 활성화되면 상태 코드 및 기타 정보를 포함하여 원본의 패킷이 직접 반환됩니다.이 설정은 버킷이 위치한 리전에 따라 다르며, 지원되는 경우에만 설정할 수 있습니다.
Origin-pull 주소: http:// 또는 https:// 접두사 없이 도메인 이름 또는 IP 주소를 입력합니다. 도메인 이름이나 IP 주소 뒤에 포트 번호를 추가할 수도 있습니다.
정확한 주소의 예시는 다음과 같습니다.
abc.example.com
abc.example.com:8080
202.96.128.86
202.96.128.86:8080
주소 설정: 특정 파일 또는 경로 설정 여부를 선택할 수 있습니다. 설정 항목 설명은 다음과 같습니다.
고정 파일설정: Origin-pull 규칙이 트리거되면 모두 고정 파일로 이동됩니다.
접두사및접미사설정: Origin-pull 규칙이 트리거될 경우, 지정한 접두사 또는 접미사가 포함된 파일 경로로 이동합니다.
예를 들어 접두사를 test로 지정하고 https://examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/path/prefix123.jpg 접근 시 origin-pull 규칙이 트리거되면 <origin address>/test/path/prefix123.jpg 로 이동합니다.
또한 접미사를 .jpg로 지정하고 https://examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/path/prefix123 접근 시 origin-pull 규칙이 트리거되면 <origin address>/path/prefix123.jpg 로 이동합니다.
주의:
지정한 접두사와 접미사 설정은 동시에 적용할 수 있습니다.
리디렉션 Code: 301, 302, 307을 선택할 수 있으며, 기본값은 302입니다.
7. 설정된 Origin-pull 규칙이 정확한지 확인하고 확인을 클릭합니다.
8. 기본적으로 COS는 origin-pull을 수행하는 가장 최근 규칙에 항상 가장 높은 우선 순위를 부여합니다. 우선 순위를 수동으로 변경하려면 규칙 목록의 우선 순위 열에서 편집 아이콘을 클릭하면 됩니다.
주의:
고우선순위 소스가 실패한 후, 저우선순위 소스 주소로 돌아가지 않고 원본 소스의 백업 소스 주소로 돌아갑니다.
예시
배경
APPID가 1250000000인 사용자가 examplebucket-1250000000이라는 버킷을 생성하고, CDN 가속 엔드포인트 도메인 이름을 활성화했습니다.
examplebucket-1250000000.file.myqcloud.com
버킷의 origin-pull 주소를 다음과 같이 구성합니다.
abc.example.com
원본 http://abc.example.com에 이미지 picture.jpg를 저장합니다.
