문제 해결
이 문서는 NetFUNNEL Fastly Agent 사용 중 발생할 수 있는 일반적인 문제와 해결 방법을 제공합니다.
설치 및 초기화
Fastly CLI 설치 실패
증상: Fastly CLI 설치가 실패하거나 명령어를 찾을 수 없습니다.
해결 방법:
- Homebrew가 설치되어 있는지 확인
brew install fastly/tap/fastly명령어를 다시 실행- 터미널을 재시작한 후 다시 시도
Compute Service 생성 실패
증상: Compute Service 생성이 실패합니다.
해결 방법:
- Fastly 계정에 Compute Services 지원이 활성화되어 있는지 확인
- Service name이 유효한지 확인
- 도메인이 올바르게 입력되었는지 확인
CNAME 등록 실패
증상: CNAME 등록이 실패하거나 TLS 인증서 발급이 되지 않습니다.
해결 방법:
- DNS provider에서 CNAME 레코드가 올바르게 설정되었는지 확인
- CNAME 값이 Fastly에서 제공한 값과 일치하는지 확인
- DNS 전파 시간을 고려하여 충분한 시간 대기
동작 문제
대기열이 적용되지 않음
증상: 트리거 규칙을 설정했지만 대기열이 적용되지 않습니다.
해결 방법:
- NetFUNNEL 콘솔에서 세그먼트 트리거 규칙이 올바르게 설정되었는지 확인
- URL이 트리거 규칙과 일치하는지 확인
- Config Store의
CLIENT_ID설정이 올바른지 확인 - Compute Service에 에이전트가 올바르게 배포되었는지 확인
- Compute Purge를 수행하여 변경 사항 적용
대기실로 리다이렉트되지 않음
증상: 대기 응답을 받았지만 대기실로 리다이렉트되지 않습니다.
해결 방법:
- Config Store의
VWR_PAGE_DOMAIN설정 확인 - Compute Service의 host 설정 확인
- Compute Purge 상태 확인
배포 문제
에이전트 배포 실패
증상: fastly compute deploy 명령어가 실패합니다.
해결 방법:
- Fastly API 토큰이 올바르게 설정되었는지 확인
fastly.toml파일의service_id가 올바른지 확인- Fastly CLI가 최신 버전인지 확인
- 네트워크 연결 상태 확인
toml 파일 오류
증상: toml 파일을 수정했지만 배포가 실패합니다.
해결 방법:
- toml 파일의 문법이 올바른지 확인
service_id와cloned_from값이 일치하는지 확인- 필수 필드가 모두 입력되었는지 확인
설정 문제
Config Store 값이 적용되지 않음
증상: Config Store를 설정했지만 값이 반영되지 않습니다.
해결 방법:
- Config Store가 Compute Service에 올바르게 연결되었는지 확인
- Key와 Value가 올바르게 입력되었는지 확인
- Compute Purge를 수행했는지 확인
- Compute Purge 완료 후 충분한 시간(몇 분) 대기
Compute Purge가 완료되지 않음
증상: Compute Purge가 오래 걸리거나 완료되지 않습니다.
해결 방법:
- Purge 상태를 확인하고 완료될 때까지 대기
- Purge가 실패한 경우 다시 시도
- Fastly 서비스 상태 확인