pilot-agent

개요

이스티오에서 데이터 플레인에 엔보이를 세팅할 때 사용되는 툴이다.
엔보이가 사이드카로 들어간 파드를 뜯어보면, 초기화 컨테이너에는 pilot-agent iptables, 일반 컨테이너로는 pilot-agent proxy라고 쓰여진 것을 볼 수 있다.
즉 엔보이가 실행될 수 있도록 세팅을 하고, 또 엔보이 프로세스를 기동하는데 사용되는 툴이라는 것이다.
직접 해당 이 툴을 사용하는 것도 가능은 하나, 보통 그렇게 사용하라고 만든 툴은 아니고 현재 띄워진 사이드카 프록시의 설정을 건드리거나 할 때 활용하기에 좋다.

환경 변수

으으마무시하게 설정할 수 있는 환경변수가 많다.[1]
이 설정들은 이스티오 오퍼레이터를 세팅할 때 전역적으로 넣어주는 것이 가능하다.

request

pilot-agent request <method> <path> [<body>] [flags]

근데 이렇게 현재 돌아가고 있는 엔보이의 관리자 api를 건드리기 위한 용도로도 사용할 수 있다.
보통 관리자 api는 그냥 일반 http로도 접근이 가능하니 이걸 왜 쓰나 싶을 텐데, distroless 이미지 같이 최소한의 명령어만 들어있는 파드에서 디버깅을 할 때는 퍽 유용하다.

관련 문서

이름 noteType created
25.05 테크니컬 라이팅 area 2025-05-07
Envoy knowledge 2025-04-07
아르고 롤아웃과 이스티오 연계 knowledge 2025-04-22
P-Istio Hands-on 스터디 1기 project 2025-04-03
책 내용 정리 project 2025-04-03
스터디 내용 사전 정리 project 2025-04-03
2주차 - 엔보이, 게이트웨이 project 2025-04-13
3주차 - 트래픽 관리 project 2025-04-19
3주차 - 네트워크 복원력 project 2025-04-23
4주차 - 이스티오 관측가능성 project 2025-04-27
1주차 - istio 소개, 첫걸음 project 2025-04-06
5주차 - 통신 보안 project 2025-05-04
6주차 - 디버깅 project 2025-05-11
7주차 - 스케일링, 멀티 클러스터 project 2025-05-18
Istio 1기 - Istio Hands-on published 2025-04-03
1W - 서비스 메시와 이스티오 published 2025-04-10
1W - 간단한 장애 상황 구현 후 대응 실습 published 2025-04-10
1W - Gateway API를 활용한 설정 published 2025-04-10
1W - 네이티브 사이드카 컨테이너 이용 published 2025-04-10
2W - 엔보이 published 2025-04-19
2W - 인그레스 게이트웨이 실습 published 2025-04-17
3W - 버츄얼 서비스를 활용한 기본 트래픽 관리 published 2025-04-22
3W - 트래픽 가중치 - flagger와 argo rollout을 이용한 점진적 배포 published 2025-04-22
3W - 트래픽 미러링 패킷 캡쳐 published 2025-04-22
3W - 서비스 엔트리와 이그레스 게이트웨이 published 2025-04-22

참고


  1. https://istio.io/latest/docs/reference/commands/pilot-agent/#envvars ↩︎