본문으로 건너뛰기

서비스 생성 및 관리

서비스 생성

CDN 서비스는 빠르고 안정적으로 웹 콘텐츠를 제공하기 위한 배포 설정의 적용 단위로 사용됩니다. CDN 서비스에서 서비스를 생성하는 방법은 다음과 같습니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.

  2. 서비스 메뉴에서 [서비스 생성] 버튼을 클릭합니다.

  3. 1단계: 서비스 및 오리진 서버에서 CDN 정보를 입력하고, [다음] 버튼을 클릭합니다.

    이미지 1단계: 서비스 및 오리진 서버

    구분설명
    서비스 이름CDN 서비스 이름 입력
    - 같은 프로젝트 내에서 중복된 서비스 이름은 사용 불가
    서비스 설명(선택)CDN 서비스에 대한 설명
    호스트 서버호스트 서버 선택
    KC CDN: 카카오클라우드 CDN의 도메인으로 자동 생성하여 사용
    사용자 도메인: 사용자가 보유한 호스트 서버를 사용
      ㄴ 프로젝트 내 최대 10개까지 설정 가능
      ㄴ 호스트 서버의 도메인 또는 IP 주소를 입력
      ㄴ 해당 호스트 서버에 대한 인증서를 선택
    * 사용자가 보유한 도메인으로 HTTPS 프로토콜을 이용하려면 사전에 인증서 관리 탭에서 인증서를 발급하시기 바랍니다.
    오리진 서버오리진 서버 선택
    KC Object Storage: 카카오클라우드 콘솔 > Object Storage에서 생성한 버킷을 선택하여 오리진 서버로 설정
      * Object Storage로 연동 시, Object Storage > 선택한 버킷의 상세 페이지 > 권한 탭에서 퍼블릭 액세스 허용을 반드시 설정해야 함
      ㄴ 버킷 접근 설정 참고
      ㄴ 버킷 생성 및 관리는 카카오클라우드 콘솔 > Object Storage에서 이용
    사용자 도메인: 사용자가 보유한 서버를 오리진 서버로 설정
      ㄴ 오리진 서버의 도메인 또는 IP 주소를 입력(단, 포트 번호 제외)
      ㄴ 허용하지 않는 IP 대역 :
         127.0.0.1
         10.0.0.0 ~ 10.255.255.255
         172.16.0.0 ~ 172.31.255.255
         192.168.0.0 ~ 192.168.255.255
         1.201.9.1 ~ 1.201.9.126
         211.110.188.1 ~ 211.110.188.62
    오리진 서버 프로토콜오리진 서버 프로토콜 선택
    HTTP: 오리진 서버에서 KC Object Storage 선택 시 지원 안 함
      ㄴ 포트 번호: 80(기본값)
    HTTPS
      ㄴ 포트 번호: 443(기본값)
    오리진 서버 포트 번호오리진 서버 포트 번호 입력
    - 양의 정수만 입력 가능
    오리진 서버 경로 (선택)오리진 서버의 경로를 입력
    - 하위 경로를 등록하여 오리진 서버 경로를 생략하고 요청
    - {URL} /{path} 형식의 오리진 서버 경로 입력
      ㄴ 디렉터리 경로만 입력 가능
    Gzip CompressionGzip Compression 사용 여부 선택

  1. 2단계: 캐시에서 정보를 입력하고, [다음] 버튼을 클릭합니다.

    이미지 2단계: 캐시

    구분설명
    만료 정책캐시 만료 정책을 선택
    오리진 서버 참조: 오리진 서버의 Cache-Control 헤더를 우선 참조
    사용자 설정: 사용자가 설정한 유지 기간 동안 캐싱
    유지 기간캐시 유지 기간을 입력
    - 최대 30일까지 설정
    URL Query StringURL Query String 포함 여부 선택
    이미지(JPG) 파일 최적화이미지(JPG) 파일 최적화 사용 여부 선택

  1. 3단계: 접근 제어에서 정보를 입력하고, [다음] 버튼을 클릭합니다.

    이미지 3단계: 접근 제어

    구분설명
    뷰어 프로토콜 정책뷰어 프로토콜 정책 설정 여부 선택
    리퍼러 헤더리퍼러 헤더 설정 여부 선택
    - 설정 안 할 시, 리퍼러 헤더가 없는 요청일 경우 접근 요청 허용함
    ㄴ 별표(*) 연속해서 입력 불가
    ㄴ 리퍼러 헤더 예시
    가능한 값
    - *.example.com
    - www.example.com
    - www.example.com/*
    - *.example.com/test/*

    불가능한 값
    - **.example.com
    - www.*.com
    - www.example.com* → 경로 슬래시(/) 지정 후에 별표(*) 사용 가능
    루트 경로루트 경로 설정 여부 선택
    - Redirect 접근 제어 설정 시, 원본 경로 입력

  1. 4단계: 검토에서 정보를 검토하고, [생성] 버튼을 클릭해 서비스를 생성합니다.

    이미지 4단계: 검토

서비스 관리

CDN 서비스에서 서비스(Service)를 관리하는 방법은 다음과 같습니다.

서비스 목록 보기

현재 생성된 서비스 목록과 서비스의 기본 정보를 조회할 수 있습니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.

  2. 서비스 메뉴를 클릭 후 서비스 목록을 확인합니다.

    이미지 서비스 목록

    구분설명
    이름서비스의 이름
    서비스 도메인CDN을 적용한 서비스의 도메인
    상태서비스의 상태
    - Running, Failed to deploy, Stopped, Provisioning
    - 각 상태값에 대한 자세한 설명은 CDN 상태 정보 참고
    최종 배포일서비스의 최종 배포 날짜
    생성자서비스를 처음 생성 요청한 사용자
    - IAM에서 사용자가 삭제되면 표기되지 않음
    [더 보기] 아이콘서비스 상세 관리 기능
    - 자세한 설명은 서비스 더 보기 참고

서비스 더 보기

서비스별로 [더 보기] 아이콘을 선택하여 아래 기능들을 실행할 수 있습니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.

  2. 서비스 메뉴 > 서비스 목록에서 [더 보기] 아이콘을 클릭한 후, 아래 기능을 실행합니다.

    기능설명
    시작 또는 재시작서비스를 배포 혹은 재배포하는 상태로 전환
    정지서비스를 종료
    - 해당 서비스의 배포를 중단하며, 서비스가 비활성화되고 콘텐츠에 대한 요청에 응답할 수 없음
    삭제서비스를 삭제
    - 삭제한 서비스는 복구할 수 없음
    Purge 요청Purge 요청을 위한 팝업창을 실행
    Running 상태에만 가능
    직전 설정을 되돌리기직전 설정을 되돌리기 위한 팝업창을 실행
    Running 상태와 이미 배포했던 서비스만 가능
    오리진 서버 설정오리진 서버를 설정하기 위한 팝업창을 실행
    캐시 설정캐시 설정하기 위한 팝업창을 실행
    뷰어 프로토콜 정책 설정뷰어 프로토콜 정책 설정하기 위한 팝업창을 실행
    리퍼러 헤더 설정리퍼러 헤더 설정하기 위한 팝업창을 실행
    루트 경로 접근 관리 설정루트 경로 접근 관리 설정하기 위한 팝업창을 실행

서비스 상세 보기

서비스의 정보와 Purge 로그 등 상세 정보를 확인할 수 있습니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.

  2. 서비스 메뉴 > 서비스 목록에서 상세 정보를 확인할 서비스를 선택합니다.

  3. 서비스의 상세 페이지에서 정보를 확인합니다.

    이미지 서비스 상세 페이지

    구분설명
    서비스 상태서비스의 상태
    서비스 도메인CDN을 적용한 서비스의 도메인
    최종 배포일서비스의 최종 배포 날짜

  1. 서비스 정보 탭에서 CDN 서비스, 캐시, 접근 제어 정보를 확인할 수 있습니다.

    구분설명
    CDN 서비스서비스 관련 전체 정보
    캐시캐시 정책, 캐시 유지 기간 등의 캐시 정보
    접근 제어뷰어 프로토콜 정책, 리퍼러 헤더, 루트 경로 등의 Access Control 설정 정보

  1. Purge 요청 로그 탭에서 Purge 로그를 확인할 수 있습니다.

    • 최근 30일간 발생한 Purge 로그를 조회할 수 있습니다. 해당 로그는 자정마다 삭제됩니다.

    이미지 Purge 요청 로그 탭

    구분설명
    Purge 로그 필터Purge 로그를 원하는 조건으로 검색
    경로Purge 요청한 대상 경로
    상태Purge 요청의 상태
    적용 일시Purge 요청하여 적용된 날짜
    작업자Purge 요청한 사용자

서비스 삭제

더 이상 사용하지 않는 서비스를 삭제할 수 있습니다.

주의

삭제한 서비스는 복구할 수 없습니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.
  2. 서비스 메뉴를 클릭 후, 서비스 목록에서 삭제할 서비스의 [더 보기] 아이콘 > 삭제를 선택합니다.
  3. CDN 서비스 삭제 팝업창에서 서비스의 이름을 입력하고, [삭제] 버튼을 클릭합니다.

Purge 요청

Purge는 캐시 서버에 저장되어 있는 콘텐츠를 삭제한 후 재배포하는 기능입니다. 서비스의 상태가 Running일 때 Purge를 요청할 수 있습니다. Purge를 요청하면 호스트 서버의 캐싱 콘텐츠를 제거하여 오리진 서버의 최신 콘텐츠로 갱신할 수 있습니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.

  2. 서비스 메뉴를 클릭 후, 서비스 목록에서 Purge 요청할 서비스의 우상단 [서비스 작업] > Purge 요청을 선택합니다.

  3. Purge 요청 팝업창에서 선택한 서비스의 이름을 확인하고, 요청하고 싶은 Purge의 대상 경로를 입력합니다.

    이미지 Purge 요청 팝업창

    구분설명
    대량 등록 에디터많은 양의 Purge 대상을 입력하고 싶은 경우 사용
    심플 에디터개별적으로 Purge 대상을 입력하고 싶은 경우 사용

직전 배포 설정으로 되돌리기

서비스 상태가 Running이고 이미 배포를 했던 서비스의 경우, 직전 배포 설정으로 되돌릴 수 있습니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.
  2. 서비스 메뉴를 클릭 후, 서비스 목록에서 직전 배포 설정으로 되돌릴 서비스의 우상단 [서비스 작업] > 직전 설정으로 되돌리기를 선택합니다.
  3. 직전 설정으로 되돌리기 팝업창에 선택한 서비스의 최종 배포일을 확인하고, [되돌리기] 버튼을 클릭합니다.

오리진 서버 설정

오리진 서버란 CDN으로 배포할 원본 콘텐츠를 저장하는 서버입니다. CDN 서비스에 오리진 서버를 설정할 수 있습니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.

  2. 서비스 메뉴를 클릭 후, 서비스 목록에서 오리진 서버를 설정할 서비스의 우상단 [서비스 작업] > 오리진 서버 설정을 선택합니다.

  3. 오리진 서버 설정 팝업창에서 선택한 서비스의 이름을 확인한 후, 변경할 내용을 입력하고 [저장] 버튼을 클릭합니다.

    구분설명
    서비스 설명(선택)CDN 서비스에 대한 설명을 입력
    오리진 서버 프로토콜오리진 서버 프로토콜 선택
    HTTP: 오리진 서버에서 KC Object Storage 선택 시 지원 안 함
      ㄴ 포트 번호: 80(기본값)
    HTTPS
      ㄴ 포트 번호: 443(기본값)
    오리진 서버 포트 번호오리진 서버 포트 번호 입력
    - 양의 정수만 입력 가능
    오리진 서버 경로 (선택)오리진 서버의 경로를 입력
    - {URL}/{path} 형식의 오리진 서버 경로 입력
    * Object Storage로 연동 시, Object Storage > 선택한 버킷의 상세 페이지 > 권한 탭에서 퍼블릭 액세스 허용을 반드시 설정해야 함
      ㄴ 버킷 접근 설정 참고
      ㄴ 버킷 생성 및 관리는 카카오클라우드 콘솔 > Object Storage에서 가능
    Gzip CompressionGzip Compression 사용 여부 선택

캐시 설정

CDN 서비스에서는 오리진 서버에 저장된 원본 콘텐츠를 별도의 캐시 서버에 복사하여 분산 저장합니다. CDN 서비스에 캐시 정책을 설정하는 방법은 다음과 같습니다.

안내

이미지(JPG) 파일 최적화 항목을 미사용으로 변경한 후 저장하면, 즉시 반영되는 것이 아닌 TTL만큼 기존 객체를 응답하다 해제된 객체를 응답하게 됩니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.

  2. 서비스 메뉴를 클릭 후, 서비스 목록에서 캐시 설정할 서비스의 우상단 [서비스 작업] > 캐시 설정을 선택합니다.

  3. 캐시 설정 팝업창에서 선택한 서비스의 이름을 확인한 후, 변경할 내용을 입력하고 [저장] 버튼을 클릭합니다.

    이미지 캐시 설정 팝업창

    구분설명
    만료 정책캐시 만료 정책을 선택
    오리진 서버 참조: 오리진 서버의 Cache-Control 헤더를 우선 참조
    사용자 설정: 사용자가 설정한 유지 기간 동안 캐싱
    유지 기간캐시 유지 기간을 입력
    - 최대 30일까지 설정
    URL Query StringURL Query String 포함 여부 선택
    이미지(JPG) 파일 최적화이미지(JPG) 파일 최적화 사용 여부 선택
    - 이미지 원본 파일 크기 : 최대 10MB까지 가능
    - 제공 파일 형식 : jpg, jpeg, png, gif
    * PNG 파일의 경우, 최적화 후 원본 파일 크기보다 용량이 늘어날 수 있습니다.

뷰어 프로토콜 정책 수정

CDN 서비스의 뷰어 프로토콜 정책을 재설정할 수 있습니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.
  2. 서비스 메뉴를 클릭 후, 서비스 목록에서 뷰어 프로토콜 정책을 설정할 서비스의 우상단 [서비스 작업] > 뷰어 프로토콜 정책 설정을 선택합니다.
  3. 뷰어 프로토콜 정책 설정 팝업창에서 선택한 서비스의 이름을 확인한 후, 변경할 내용을 입력하고 [저장] 버튼을 클릭합니다.

리퍼러 헤더 설정

CDN 서비스의 리퍼러 헤더를 재설정할 수 있습니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.
  2. 서비스 메뉴를 클릭 후, 서비스 목록에서 리퍼러 헤더를 설정할 서비스의 우상단 [서비스 작업] > 리퍼러 헤더 설정을 선택합니다.
  3. 리퍼러 헤더 설정 팝업창에서 선택한 서비스의 이름을 확인한 후, 변경할 내용을 입력하고 [저장] 버튼을 클릭합니다.

루트 경로 접근 관리 설정

CDN 서비스의 루트 경로 접근 관리를 재설정할 수 있습니다.

  1. 카카오클라우드 콘솔 > Beyond Networking Service > CDN 메뉴로 이동합니다.
  2. 서비스 메뉴를 클릭 후, 서비스 목록에서 루트 경로를 재설정할 서비스의 우상단 [서비스 작업] > 루트 경로 접근 관리 설정을 선택합니다.
  3. 루트 경로 설정 팝업창에서 선택한 서비스의 이름을 확인한 후, 변경할 내용을 입력하고 [저장] 버튼을 클릭합니다.