Content Delivery > CDN > 콘솔 사용 가이드

본 문서에서는 웹 콘솔을 이용하여 CDN 서비스를 구성하고 이용하는 방법을 설명합니다.

CDN 서비스 생성 순서

1.[Contents Delivery] > [CDN] 의 [CDN 서비스] 탭에서 [생성] 버튼을 클릭하면 CDN 서비스를 생성할 수 있는 [그림 1]의 CDN 서비스 생성 화면으로 이동합니다.
CDN 서비스에 이용될 도메인 명은 자동으로 생성됩니다. 소유하고 있는 도메인이 있는 경우, Domain Alias 기능을 이용해서 서비스할 수 있습니다.

[그림 1] CDN 서비스 생성 화면

[그림 1] CDN 서비스 생성 화면

2.'서비스 지역'을 선택합니다.
서비스 제공 형태에 따라 KOREA/GLOBAL 리전을 선택할 수 있습니다. 각국에 존재하는 캐시 서버를 이용하여 전세계를 대상으로 서비스 하기를 원하시면 GLOBAL을 선택하고, 한국 내에서만 서비스하는 경우에는 KOREA를 선택하십시오. KOREA를 선택하는 경우 좀 더 낮은 가격에 서비스 이용이 가능합니다.

3.'설명'을 입력합니다.
CDN 서비스에 추가적인 설명을 입력합니다.

4.'원본 서버'와 '원본 경로'를 입력합니다.
TOAST Cloud의 Infrastructure에서 생성한 인스턴스나 기존에 보유하고 있는 서버를 이용하여 서비스할 수 있습니다.
원본 서버는 IP 또는 도메인 형태로 입력이 가능하며, Port를 지정할 수 있습니다.
URL Path 형태의 하위 경로는 '/'를 포함하여 원본 경로에 입력해주세요. 원본경로 입력은 선택항목입니다.

5.'Domain Alias'를 설정합니다.
CDN 서비스 생성이 완료 되면 *.cdn.toastcloud.com 형태의 서비스 도메인이 자동으로 발급되며, 발급된 도메인을 그대로 서비스에 이용하실 수 있습니다.
하지만 개인 혹은 회사가 소유한 도메인을 이용하여 CDN 서비스를 제공해야 할 경우, 'Domain Alias' 설정을 이용하실 수 있습니다.
Domain Alias 란 TOAST Cloud에서 제공하는 도메인 외에 개인 혹은 회사가 소유한 도메인으로도 CDN 서비스가 가능하도록 하는 서비스입니다.
Domain Alias 항목에 소유한 도메인 주소를 설정하고, 해당 도메인의 네임서버 설정을 변경해 주세요.
TOAST Cloud에서 발급받은 CDN 서비스 주소를 CNAME 레코드로 추가 해주시면 소유한 도메인으로도 서비스가 가능합니다.

6.'Cache'를 설정합니다.

  • Cache 만료 설정
    캐시 만료 설정을 이용하여 캐시 만료 시간을 사용자화 가능합니다. “원본 설정 사용" 옵션이 기본 값입니다. 캐시 만료 시간을 지정하고 싶은 경우 [사용자 설정 사용] 버튼을 클릭하고 "Cache 만료 시간 (초)" 에서 캐시 만료 시간을 변경합니다.

    주의
    만일 원본 서버 설정에 캐시 만료 시간이 지정되어 있다면 콘솔에서 설정한 "Cache 만료 시간 (초)" 값은 무시됩니다. CDN 서비스를 이용해 만료시간을 지정하고 싶은 경우 원본 서버의 캐시 만료 설정을 제거합니다.

    참고
    캐시 만료 기본값은 0 입니다. 기본값 0으로 설정한 경우 캐시 만료시간은 604,800(단위/초) 입니다. 캐시 만료 시간은 기본값 0을 포함하여 0 ~ 2,147,483,647(단위/초)의 값을 입력할 수 있습니다.

  • Referrers 접근 관리
    특정 referrer의 경우 사용자 콘텐츠에 대한 접근을 제한할 수 있습니다.
    "Blacklist" 타입을 이용할 경우 Referrers에 입력된 Referrer 리스트는 접근이 제한되며, "Whitelist" 타입을 이용할 경우 접근이 허용됩니다.
    Regular expression 형태의 입력을 지원하며 여러 개의 referrer를 제어하고 싶은 경우 다음 라인에 연속하여 입력합니다.

7.콜백이 필요한 경우 Callback 정보를 입력합니다. 콜백과 관련한 상세한 내용은 문서의 [콜백 설정]을 참고해주세요.

8.[확인] 버튼을 클릭하면 CDN 서비스 생성 요청이 완료됩니다.

생성 요청 이후 서비스 배포가 완료되기까지 수 분 정도 (최대 한 시간) 소요됩니다. 배포가 완료된 후 서비스 이용이 가능합니다.

CDN 서비스 설정 변경

설정 변경을 통해 추가 설명 및 원본 서버 정보를 변경할 수 있습니다.
하지만 서비스 이름과 지역은 변경할 수 없으므로 변경을 원하실 경우 기존 서비스를 삭제한 후 새로운 서비스로 생성해야 합니다.

1.변경을 원하는 서비스를 CDN 서비스 목록에서 선택합니다.
2.화면 하단의 [기본 정보] 탭의 [수정] 버튼을 클릭합니다.

[그림 2]와 같이 변경 가능한 항목들이 활성화 됩니다.

[그림 2] 변경 가능한 서비스 기본 정보

[그림 2] 변경 가능한 서비스 기본 정보

3.변경 가능한 항목은 설명, 원본 서버 정보, Domain Alias, Callback 설정입니다.
4.[확인] 버튼을 클릭해 변경을 완료합니다.

원본 서버가 변경되면 기존에 캐시되어있던 모든 내용은 재배포되며 콘텐츠 양에 따라 재배포 시간은 달라집니다.

CDN 캐시 설정 변경

1.변경을 원하는 서비스를 CDN 서비스 목록에서 선택합니다.
2.[그림 3]에서와 같이 [Cache 설정] 탭의 [수정] 버튼을 클릭합니다.

[그림 3] Cache 설정 정보

[그림 3] Cache 설정 정보

3.Cache 만료 설정에서 만료 설정 방식을 선택합니다.

  • 원본 설정 사용
    원본 서버의 캐시 만료설정을 이용하도록 설정합니다.
  • 사용자 설정 사용
    캐시 만료 시간 값을 이용하여 원하는 시간으로 캐시 만료 설정이 가능합니다.

    주의
    만일 원본 서버 설정에 캐시 만료 시간이 지정되어 있다면 [그림3]에서 입력한 "Cache 만료 시간 (초)" 값은 무시됩니다. CDN 서비스를 이용해 만료시간을 지정하고 싶은 경우 원본 서버의 캐시 만료 설정을 제거합니다.

4.원하는 경우 Referrer를 이용해 접근 관리를 할 수 있습니다.
특정 referrer의 경우 사용자 콘텐츠에 접근 가능 여부를 관리할 수 있습니다. Regular expression 형태로 입력하고 여러 개의 referrer를 제어할 경우 입력 창에 라인을 추가하여 입력합니다.
5.캐시 설정 후 특정 URL 호출이 필요한 경우 Callback URL을 설정할 수 있습니다.
6.[확인] 버튼을 클릭해 캐시 설정을 변경합니다.

콜백 설정

CDN 서비스 변경 작업(생성,수정,정지/재개,삭제 작업)은 변경 요청 후 최대 수십분이 소요될 수있습니다. 서비스 변경 작업이 완료된 후 미리 설정한 콜백 URL로 서비스 변경 작업의 완료 여부와 서비스 정보를 전달 받을 수 있습니다.

  1. 콜백 URL 과 콜백 HTTP Method를 입력합니다.
  2. Request URI의 Query Parameter로 CDN 서비스 변경 작업에 대한 결과를 받으려면 콜백 URL에 Path 변수를 포함하여 입력해주세요.
Path Variable 설명 예시 전달 값
{appKey} CDN 상품의 앱 키 콘솔에서 발급받은 앱 키
{domain} CDN 서비스 이름 xxxxxx.cdn.toastcloud.com
{status} 현재 CDN 서비스의 상태 OPEN, SUSPEND, CLOSE, ERROR
{isSuccessful} 서비스 변경 작업 성공 여부 (API V1.0은 지원 하지 않습니다.) "true" 또는 "false"

예시 GET http://test.callback.com?appKey={appKey}&domain={domain}&status={status}&deploySuccess={isSuccessful}

  1. 콜백 전달시 CDN 서비스의 정보를 요청 본문(Request Body)로 전달합니다.

API V1.0을 통해 변경할 경우 요청 본문의 내용은 아래와 같습니다.

{  
   "seq": Integer,
   "appKey": String,
   "domain": String,
   "domainAlias": String,
   "type": String,
   "region": String,
   "description": String,
   "status": String, 
   "createTime": DateTime,
   "useOrigin": String,
   "maxAge": String,
   "referrerType": String,
   "referrers": String,
   "deleteTime": DateTime,
   "company": String,
   "origins":[  
      {  
         "seq": Integer,
         "distributionSeq": Integer,
         "origin": String,
         "originPath": String,
         "port":Integer,
      }
   ],
   "callbackHttpMethod": String,
   "callbackUrl": String
}

CDN 콘솔을 통해 변경을 하거나 API V1.5 을 통해 변경할 경우 응답 형식은 아래와 같습니다.

{  
   "header":{  
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": Boolean
   },
   "distribution":{  
      "seq": String,
      "appKey": String,
      "domain": String,
      "domainAlias": String,
      "type": String,
      "region": String,
      "description": String,
      "status": String,
      "createTime": DateTime,
      "useOrigin": String,
      "maxAge": String, 
      "referrerType": String,
      "referrers": String,
      "deleteTime": DateTime,
      "company": String,
      "origins":[  
         {  
            "seq": Integer,
            "distributionSeq": Integer,
            "origin": String,
            "originPath": String,
            "port": Integer
         }
      ],
      "callback":{  
         "httpMethod": String,
         "url": String
      }
   },
   "successful": Boolean
}

[주의] API V1.0과 V1.5 버전에 따라 콜백 동작이 다르므로 유의해주세요. API V1.0은 CDN 서비스 생성과 수정시에만 콜백이 호출되고, API V1.5는 생성,수정,일시정지와 재개,삭제시 콜백을 호출합니다. API 버전에 따라 콜백의 요청 본문(Request Body)의 json 데이터 형식이 다르므로 유의해주세요.

Cache 재배포

원본 콘텐츠의 내용이 변경된 경우 기존에 지정된 캐시 만료 시간 이후에는 새로운 콘텐츠로 캐시가 업데이트 됩니다. 하지만 빠르게 캐시 내용을 재배포 하고 싶은 경우 "Cache 재배포" 기능을 이용해 기존 캐시를 새로운 콘텐츠로 업데이트 합니다.

1.변경을 원하는 서비스를 CDN 서비스 목록에서 선택합니다.
2.[그림 4]와 같이 [Cache 재배포] 탭을 클릭합니다.

[그림 4] Cache 재배포

[그림 4] Cache 재배포

3.캐시 재배포 타입을 선택합니다. 3가지 타입의 캐시 재배포 방식을 제공합니다.

  • Item: 정확한 파일명과 경로 설정을 통해 원하는 파일만 재배포 가능합니다.
    • 예) /path/to/file1.jpg
  • Wildcard: 파일명과 경로명에 와일드카드 문자를 이용가능합니다.
    • * : 임의의 문자열
    • ? : 1개의 문자
    • \ : Escape 문자
      • 예) /images/games/\*.jpg
      • /\/sports/\.jpg
      • /images/sports/ac?e/\*.jpg
  • All: 모든 캐시를 한꺼번에 재배포 합니다.

4.선택한 캐시 재배포 타입에 맞게 재배포할 파일을 지정합니다.

5.[Cache 재배포] 버튼을 클릭해 재배포 요청을 합니다.
재배포까지는 수 분의 시간이 소요됩니다. (용량에 따라 소요 시간은 달라질 수 있습니다.)

[주의] 캐시 재배포 사용량 제한
서비스별로 캐시 재배포 사용 횟수가 제한되므로 제한 사용량을 초과한 경우 사용량이 초기화된 이후에 다시 사용할 수 있습니다.
- ITEM 타입: 시간당 60회 제한, 한 번에 요청할 수 있는 최대 Path 수: 1000개 제한
- Wildcard 타입: 시간당 60회 제한, 한 번에 요청할 수 있는 최대 Path : 10개 제한
- ALL 타입: 시간당 5회 제한

감시설정

예상치 못한 트래픽이 발생 할 경우를 대비하여, 감시 설정을 등록할 수 있습니다. 지정된 값 이상의 트래픽이 발생할 경우 이메일을 발송하며, 강제 정지 옵션을 설정하면 이메일 발송 후 CDN 서비스를 정지합니다.

1.변경을 원하는 서비스를 CDN 서비스 목록에서 선택합니다.
2.[그림 5]의 [감시 설정] 탭에 있는 [수정] 버튼을 클릭합니다.

[그림 5] 감시 설정

[그림 5] 감시 설정

3.누적 트래픽 타입으로 제한 할 트래픽 양을 지정합니다. 단위는 Byte입니다.
4.+/- 버튼을 이용해 여러 개의 감시설정을 추가 및 삭제합니다.
5.지정한 값 이상의 트래픽이 감지 되었을 경우에 서비스 강제 정지를 원하면 강제 정지 설정을 [예]로 활성화합니다.
6.[확인] 버튼을 눌러 변경된 내용을 적용합니다.

통계 확인하기

네트워크 전송량, HTTP 상태코드 별 통계 및 Top 콘텐츠에 대한 통계를 확인할 수 있습니다.

1.[Contents Delivery] > [CDN] 의 [통계] 탭을 클립합니다.

[그림 6] CDN 통계 조회

[그림 6] CDN 통계 조회

2.통계를 확인하기 원하는 CDN 서비스를 선택합니다.
3.검색 기간을 입력합니다.
4.검색 기간내 데이터 주기는 선택한 기간에 따라 자동으로 선택됩니다.
5.[검색] 버튼을 클릭합니다.

Domain Alias 사용 예

CDN 서비스 생성 후 random-exam.cdn.toastcloud.com 이라는 도메인이 발급되고, 기존 고객이 소유하던 alias.nhnentcustomer.com을 이용하여 서비스 하기 위한 설정 방법입니다.

1.Toast Cloud CDN 생성 이후 자동으로 발급된 random-exam.cdn.toastcloud.com 확인합니다.
2.기본정보 설정 탭의 Domain Alias 항목에 서비스에 사용할 고객 도메인 alias.nhnentcustomer.com 입력합니다.
3.nhnentcustomer.com 네임서버 관리 항목에서 random-exam.cdn.toastcloud.com을 이용해 CNAME 레코드를 추가합니다. (도메인 제공 업체에 따라 설정 방법은 다를 수 있습니다. 자세한 사항은 도메인 제공 업체에게 문의해주십시오.)
4.alias.nhnentcustomer.com 으로 서비스 시작합니다.