Windmill 사용법

 

Windmill은 강력한 워크플로우 자동화 및 스크립팅 플랫폼입니다. 이 가이드에서는 Windmill의 설치부터 고급 기능 활용까지 단계별로 설명하겠습니다.

 

1. 설치 및 환경 설정

 

1.1 Docker 설치

Windmill은 Docker를 통해 쉽게 설치할 수 있습니다.

sudo apt-get update sudo apt-get install docker.io

 

1.2 Windmill 이미지 다운로드

docker pull ghcr.io/windmill-labs/windmill:main

 

1.3 Windmill 실행

docker run -d --name windmill -p 8000:8000 ghcr.io/windmill-labs/windmill:main

 

1.4 초기 설정

브라우저에서 http://localhost:8000에 접속하여 관리자 계정을 생성합니다.

 

2. 기본 사용법

 

2.1 워크스페이스 생성

대시보드에서 "Create Workspace" 클릭

워크스페이스 이름 입력

"Create" 버튼 클릭

 

2.2 첫 번째 스크립트 작성

"Scripts" 메뉴 선택

"New Script" 클릭

언어 선택 (예: Python)

스크립트 작성:

def main(name: str): return f"Hello, {name}!"

"Save" 버튼 클릭

 

2.3 스크립트 실행

저장된 스크립트 선택

"Run" 버튼 클릭

필요한 매개변수 입력

실행 결과 확인

 

3. 고급 기능

 

3.1 변수 설정

"Variables" 메뉴 선택

"New Variable" 클릭

변수 이름과 값 입력

보안 수준 선택 (일반/비밀)

 

3.2 리소스 연결

"Resources" 메뉴 선택

원하는 리소스 유형 선택 (예: Database)

연결 정보 입력

"Test Connection" 후 저장

 

3.3 워크플로우 생성

"Flows" 메뉴 선택

"New Flow" 클릭

플로우 이름 입력

노드 추가 및 연결

"Save" 버튼 클릭

 

3.4 스케줄 설정

워크플로우 또는 스크립트 선택

"Schedule" 탭 클릭

Cron 표현식 입력 또는 GUI 사용

"Save Schedule" 클릭

 

4. 통합 및 확장

 

4.1 API 연동

"API" 메뉴 선택

API 키 생성

외부 시스템에서 Windmill API 호출:

curl -H "Authorization: Bearer YOUR_API_KEY" \\\\ -H "Content-Type: application/json" \\\\ -X POST \\\\ -d '{"args": {"name": "World"}}' \\\\ <http://localhost:8000/api/w/YOUR_WORKSPACE/jobs/run/script/YOUR_SCRIPT>

 

4.2 커스텀 도커 이미지 사용

Dockerfile 생성:

FROM ghcr.io/windmill-labs/windmill:main RUN pip install your-custom-package

이미지 빌드 및 푸시

Windmill 설정에서 커스텀 이미지 지정

 

4.3 버전 관리 연동

"Settings" > "Version Control" 선택

Git 저장소 URL 입력

인증 정보 설정

"Connect" 클릭

 

5. 모니터링 및 로깅

 

5.1 작업 이력 확인

"Jobs" 메뉴 선택

필터 적용하여 원하는 작업 조회

작업 상세 정보 및 로그 확인

 

5.2 알림 설정

"Settings" > "Notifications" 선택

알림 채널 추가 (이메일, Slack 등)

알림 규칙 설정

 

6. 보안 및 권한 관리

 

6.1 사용자 관리

"Settings" > "Users" 선택

새 사용자 추가 또는 기존 사용자 편집

역할 및 권한 할당

 

6.2 그룹 관리

"Settings" > "Groups" 선택

새 그룹 생성

사용자를 그룹에 할당

그룹 단위 권한 설정

 

7. 성능 최적화

 

7.1 캐시 설정

스크립트 또는 워크플로우 선택

"Cache" 탭 클릭

캐시 유효 기간 설정

"Enable Caching" 체크

 

7.2 병렬 처리 구성

워크플로우 편집

병렬 실행 가능한 노드 그룹화

"Run in Parallel" 옵션 활성화

 

8. 문제 해결 및 디버깅

 

8.1 로그 분석

문제가 발생한 작업 선택

"Logs" 탭 확인

오류 메시지 및 스택 트레이스 분석

 

8.2 테스트 모드 사용

스크립트 또는 워크플로우 선택

"Test" 버튼 클릭

다양한 입력값으로 테스트 실행

 

결과 검증

 

이 가이드를 통해 Windmill의 기본적인 사용법부터 고급 기능까지 다양한 측면을 살펴보았습니다. Windmill을 활용하면 복잡한 워크플로우를 쉽게 자동화하고 관리할 수 있으며, 다양한 시스템과의 통합을 통해 업무 효율성을 크게 향상시킬 수 있습니다. 지속적인 학습과 실험을 통해 Windmill의 잠재력을 최대한 활용해 보시기 바랍니다.