Data Connection 에이전트 설치

Data Connection 에이전트는 조직의 네트워크 안에 설치하고 Foundry에서 관리하는 프로그램입니다. Foundry 워커가 사설 시스템에 접근할 네트워크 경로를 제공하는 에이전트 프록시로 사용할 수 있고, 기존 에이전트 워커 연결에서는 호스트에서 수집 및 내보내기 작업도 실행합니다. 새 소스에는 Foundry 워커를 권장하며 사설망에는 에이전트 프록시 정책을 연결합니다.

에이전트 리소스와 권한

Data Connection의 Agents 탭에서 New agent를 선택합니다. 버튼이 보이지 않으면 생성 권한을 확인합니다. 조직 수준의 Organization administrator, Data flows administrator 또는 Create agent 워크플로를 가진 사용자 지정 역할과, 저장할 프로젝트의 Editor 또는 Owner 권한이 필요합니다.

이름과 저장할 프로젝트를 지정합니다. 에이전트는 프로젝트에 저장되는 리소스이며 생성 후의 조회, 관리와 소스 연결 권한도 프로젝트 및 리소스 권한으로 통제합니다. 전용 프로젝트에 두는 것이 권장됩니다. 생성할 수 있는 권한과 다운로드 링크 생성 같은 관리 권한은 같지 않을 수 있으므로 권한 및 운영 설정을 확인합니다.

전용 호스트 준비

에이전트는 전용 호스트에서 하나만 실행합니다. 같은 호스트에 여러 Foundry 에이전트를 실행하는 구성은 지원하지 않으며, 다른 업무 서비스와의 동거도 피합니다. AWS, Azure, GCP의 Linux VM이나 조직 소유 Linux 서버를 사용할 수 있습니다.

항목	권장 구성
운영체제	64비트 Linux. RHEL 8 이상, Ubuntu 22.04 이상 또는 동등한 배포판
CPU	4코어
메모리	16 GB
디스크	`/opt`에 마운트한 500 GB의 사용 가능 공간. SSD 권장

번들 JDK는 Linux/x86-64용입니다. AWS Graviton 같은 ARM 호스트에서 별도 JDK를 쓰려면 service/bin/launcher-static.yml의 javaHome을 변경할 수 있지만 권장되지 않으며 향후 지원되지 않을 수 있습니다.

Windows 설치는 Linux 호스트나 Linux VM을 확보할 수 없는 경우에만 검토합니다. Windows 에이전트는 일부 기능, 특히 테이블 내보내기를 지원하지 않습니다. Windows의 시작 및 재시작 설정은 운영 설정을 따릅니다.

호스트의 프로세스 제한은 다음 값을 권장합니다. 각각 hard와 soft limit에 적용합니다.

제한	값
Core file size	`0`
Open files	`262144`
Running processes	`65536`
Stack size	`32768 KB`
Max locked memory	`unlimited`

에이전트 호스트 요구사항

네트워크 양쪽 허용

에이전트가 Foundry로 연결을 시작합니다. Foundry에서 에이전트 호스트로 새 인바운드 연결을 열도록 구성하는 방식이 아닙니다. 다음 두 경계를 모두 허용해야 합니다.

에이전트 호스트에서 Foundry로 나가는 연결을 허용합니다. 필요한 도메인과 포트는 설치 마법사의 Server Setup에서 확인합니다. 조직 네트워크에 따라 방화벽이나 프록시 설정이 필요합니다.
Foundry의 Control Panel > Network ingress에서 에이전트 서버의 실제 발신 IP를 허용합니다.

클라우드 Foundry의 VPC에 인터넷을 통해 접근하는 경우에도 두 조건이 각각 적용됩니다. 실제 설치 화면에 표시되는 접속 주소와 조직의 네트워크 경로를 사용합니다.

에이전트 호스트의 외부 연결

Foundry의 인바운드 허용

에이전트 호스트에서 확인할 HTTP 진단 명령은 다음과 같습니다. FOUNDRY_URL에는 실제 HTTPS 기본 URL을 지정합니다.

: "${FOUNDRY_URL:?Foundry HTTPS 기본 URL을 설정하세요}"
if curl --fail --silent --show-error --output /dev/null \
  "${FOUNDRY_URL%/}/magritte-coordinator/api/ping"; then
  printf 'Foundry 진단 엔드포인트가 HTTP 성공 응답을 반환했습니다.\n'
else
  printf 'Foundry 연결 또는 HTTP 응답을 확인해야 합니다.\n' >&2
  false
fi

이 요청은 해당 엔드포인트의 연결을 확인합니다. 소스 인증이나 전체 동기화 성공을 검증하는 절차는 아닙니다. 원천 시스템에 연결할 인증 정보와 호스트에서 원천으로 가는 네트워크 경로도 별도로 필요합니다.

호스트 방화벽은 필요한 목적지만 허용하도록 구성합니다. 에이전트가 Foundry와 승인된 원천 시스템에 접근할 연결은 유지합니다.

다운로드와 설치

Data Connection의 설치 안내에서 패키지를 내려받아 준비한 디스크 위치에 풉니다. 실행 파일과 초기 설정은 해당 플랫폼 인스턴스의 안내를 사용합니다. 프록시 또는 TLS 검사 때문에 추가 CA가 필요하다면 다운로드 전에 인증서와 프록시 설정을 준비해야 합니다.

에이전트가 시작되면 Foundry의 에이전트 페이지에서 연결 상태를 확인합니다. 이어서 자동 업그레이드 시간대를 구성하여 보안 및 안정성 업데이트를 받도록 합니다.

자동 재시작

프로세스가 종료되거나 호스트가 재시작되었을 때 자동으로 복구하려면 Agent Manager의 재시작 설정이 필요합니다. cron 작업을 만들 수 있는 사용자로 서비스 디렉터리에서 실행합니다. AGENT_MANAGER_DIR는 실제 설치 루트입니다.

: "${AGENT_MANAGER_DIR:?Agent Manager 설치 루트를 설정하세요}"
(
  cd "$AGENT_MANAGER_DIR/service" &&
  ./bin/auto_restart.sh
)

업그레이드나 이동을 위해 자동 재시작을 잠시 끌 때는 같은 위치에서 다음 명령을 사용합니다.

: "${AGENT_MANAGER_DIR:?Agent Manager 설치 루트를 설정하세요}"
(
  cd "$AGENT_MANAGER_DIR/service" &&
  ./bin/auto_restart.sh clear
)

역할에 따른 운영

공통 설정에서는 권한, 인증서, 프록시, 모니터링, 업그레이드와 호스트 이동을 관리합니다.
에이전트 프록시는 Foundry 워커의 사설망 연결 경로와 허용 목록을 구성합니다.
에이전트 워커는 기존 호스트 실행 방식의 자원, 업로드 및 인증 정보 제약을 설명합니다.
문제 해결은 인증서 복구, 상태 및 포트 충돌, 메모리와 다운로드 문제를 다룹니다.

Keyboard shortcuts