akamai?

CDN 서비스를 제공하는 회사 중 하나입니다.
이 문서는 akamai에서 캐싱되는 리소스를 CLI를 사용해 purge하는 방법을 정리했습니다.
macOS(linux)에서 하는 방법을 기본으로 합니다. 설치 방법 외에는 windows도 동일합니다.

환경 설정

.edgerc 파일 생성

무효화를 실행하기 앞서 자격증명을 위한 .edgerc 파일이 필요합니다.
파일 생성을 위해 API Client를 생성해야 합니다.

[메뉴 > ACCOUNT ADMIN > Identity & access > Users and API Clients]
에서 [Create API client]를 클릭하여 생성할 수 있습니다.

생성을 완료하게 되면 .edgerc 파일을 다운받을 수 있습니다.

파일 예시

[default] 
client_secret = abcdEcSnaAt123FNkBxy456z25qx9Yp5CPUxlEfQeTDkfh4QA=I 
host = akab-lmn789n2k53w7qrs10cxy-nfkxaa4lfk3kd6ym.luna.akamaiapis.net 
access_token = akab-zyx987xa6osbli4k-e7jf5ikib5jknes3
Client_token = akab-nomoflavjuc4422-fa2xznerxrm3teg7

• default: 섹션을 명시할 수 있습니다. default가 기본 값이고, 여러 정보를 관리하고 싶으면 섹션을 추가해서 관리할 수 있습니다.
  공식 문서에서 .edgerc 파일을 $HOME 밑에 만들라고 가이드하고 있습니다. $HOME/.edgerc로 파일을 생성(이동)합니다. $HOME 하위에 두는 것이 기본 값이며 원하는 위치에 두어도 나중에 옵션으로 설정가능합니다.

CLI 설치

저는 CLI를 실행하는 환경에서 homebrew 설치하려면 이것저것 작업이 필요해 바이너리 파일로 설치했습니다.

homebrew로 설치하기

⚠️ 사전에 homebrew가 설치되어 있어야 합니다.

$ brew install akamai

그 외

바이너리 파일로 설치하기

바이너리 파일 다운 받기

1. 바이너리 파일 github에서 원하는 버전 및 환경에 맞는 파일을 다운로드 합니다.
2. 다운로드 받은 파일을 환경변수로 설정된 경로 하위로 이동 시킵니다.
   환경변수 설정 확인은 echo $PATH로 할 수 있습니다.

$ mv ~/Downloads/akamai-v1.5.5-linuxamd64 $PATH/

2. 다운 받은 파일의 권한 설정을 합니다.

$ chmod +x {$PATH}/akamai-v1.5.5-linuxamd64

소스 컴파일

akamai 소스 코드를 clone받아서 직접 컴파일 하는 방법이 있습니다. GO가 사전에 설치되어 있어야 합니다. 이 방법은 문서에서 다루지 않겠습니다. 공식 문서를 참고하세요.

설치 확인

$ akamai --version
akamai version 1.5.5

👍

Purge

purge 명령어 사용을 위해 akamai cli로 설치합니다.

$ akamai install purge

사용법

 $ akamai purge --edgerc {.edgerc 파일 위치} --section {.edgerc 파일 내 section 이름} invalidate [URLs]

• URLs: 파일의 full URL을 적습니다. 띄어쓰기로 구분하여 여러 파일을 한번에 purge할 수 있습니다.

옵션

• --edgerc : .edgerc 파일의 위치 (기본 값: $PATH/.edgerc)
  기본 값 외에 별도의 디렉터리 하위에 위치하도록 했다면 이 옵션을 사용합니다.
• --section : .edgerc 파일에 있는 section 이름 (기본 값: default)

  --edgerc 옵션 사용 시 --section 옵션도 같이 명시해 주세요.