설치 및 초기화

이 가이드는 NetFUNNEL Fastly 에이전트의 설치 및 초기화 과정을 설명합니다.

---

1단계: Client ID 가져오기

1. NetFUNNEL 콘솔로 이동
2. 우측 상단의 프로필 아이콘 클릭
3. 통합 자격 증명 (Integration Credentials) 메뉴 선택
4. Client ID 복사

Client ID 확인 위치

콘솔 화면 우측 상단의 프로필 아이콘을 클릭한 후, 통합 자격 증명 메뉴에서 확인할 수 있습니다.

---

2단계: Fastly CLI 설치

Fastly CLI를 설치합니다:

brew install fastly/tap/fastly

---

3단계: Compute Service 설정

Compute Service 생성

1. Fastly 콘솔 → [Compute] 이동
2. 우상단의 [Create service] 클릭
3. [+ Use starter kit] 선택
4. Service name 입력
5. Add your own domain에 compute를 적용할 도메인 입력
6. [Next: Choose a starter kit] 클릭
7. Default starter for Rust 선택
8. [Finalize and deploy] 클릭

CNAME 등록

1. Deploy 완료 후 Additional setup의 Point your custom domain to Fastly 확인
2. [Issue TLS Certification] 클릭
3. Your DNS provider에서 도메인이 등록된 서비스 선택
4. 해당 서비스에서 CNAME 등록

Service Configuration 설정

버전 관리

Fastly compute는 수정할 때마다 새로운 버전으로 clone해야 수정이 가능합니다.

1. [Edit configuration] (또는 [Service configuration]) 클릭
2. [Clone version 1 (active) to edit] 클릭

nf_core host 생성

1. Origins 메뉴 선택
2. Hostname에 serverUrl 도메인 입력
3. [Add] 클릭
4. 생성한 host 선택 → Edit 페이지 이동
5. Name을 nf_core로 변경
6. [Update] 클릭

nf_setting host 생성

1. [+ Create a host] 클릭
2. Hostname에 settingUrl 도메인 입력
3. [Add] 클릭
4. 생성한 host 선택 → Edit 페이지 이동
5. Name을 nf_setting으로 변경
6. [Update] 클릭

origin host 생성

1. [+ Create a host] 클릭
2. Hostname에 원본 주소 입력
3. [Add] 클릭
4. 생성한 host 선택 → Edit 페이지 이동
5. Name을 origin으로 변경
6. [Update] 클릭

Activate

1. 우상단의 [Activate] 클릭하여 저장

---

4단계: Config Store 설정

Config Store 생성

1. Resources 메뉴 → Config stores 이동
2. 우상단의 [+ Create store] 클릭
3. Store name: nf_config_store 입력
4. [Create] 클릭
5. [Add item] 클릭
6. 다음 표를 참고하여 추가:

Key	Value
CLIENT_ID	{'{CLIENT_ID}'}

CLIENT_ID는 NetFUNNEL 콘솔에서 확인하세요.

Config Store 연결

1. 상단 탭의 [Linked Services] 선택
2. [Link service] 클릭
3. 위에서 생성한 Compute service 선택
4. [Next] 클릭
5. [Link and activate] 클릭
6. Active Service Versions 창에서 [Confirm and activate] 클릭

---

5단계: 토큰 생성

1. Account → API tokens → Personal tokens 이동
2. 우상단의 [+ Create Token] 클릭
3. [Continue] 클릭 후 다시 로그인
4. Name 입력
5. Expiration: Never expire 선택
6. [Create Token] 클릭

---

6단계: 에이전트 배포

에이전트 파일 다운로드

https://agent-lib.stclab.com/agents/cdn/fastly/netfunnel-fastly-agent-latest.tar 에서 netfunnel-fastly-agent.tar 파일 다운로드

toml 파일 수정

1. 다운로드한 에이전트 파일 압축 해제
2. fastly.toml 파일 열기
3. Fastly 콘솔에서 compute service의 ID 복사
4. cloned_from과 service_id에 복사한 ID 입력:

authors = []
cloned_from = "{SERVICE_ID}"
description = "Fastly agent for NetFUNNEL - Rust implementation"
language = "rust"
manifest_version = 3
name = "NetFUNNEL-Fastly-Agent-Rust"
service_id = "{SERVICE_ID}"

에이전트 배포

1. netfunnel-fastly-agent 폴더에서 터미널 열기
2. 아래 명령어 실행:

fastly compute deploy

에이전트 코드가 compute로 배포됩니다.

---

다음 단계

• 초기화 설정: Config Store 및 부가 기능 설정
• 문제 해결: 일반적인 문제 및 해결 방법