Environments
n8n v2.47요약
Environments를 사용하면 워크플로와 자격 증명, 변수, 데이터 테이블 같은 n8n 리소스를 개발, 프로덕션 등 릴리즈 프로세스의 단계에 따라 옮길 수 있습니다. Environments는 다음에서 사용할 수 있습니다.
Environments를 사용하면 워크플로와 자격 증명, 변수, 데이터 테이블 같은 n8n 리소스를 개발, 프로덕션 등 릴리즈 프로세스의 단계에 따라 옮길 수 있습니다. 한 인스턴스에서 변경 사항을 빌드하고 테스트한 뒤 다음 단계로 프로모트합니다.
기능 제공 여부
Environments는 다음에서 사용할 수 있습니다.
- n8n Cloud: Enterprise
- 셀프 호스팅: Enterprise
인스턴스 소유자와 인스턴스 관리자만 환경을 설정하고, 프로모트와 적용을 수행하고, 프로모션을 리뷰할 수 있습니다.
Preview 상태
Environments는 Preview 상태이며 향후 릴리즈에서 변경될 수 있습니다. 프로덕션 인스턴스에 설정하기 전에 테스트 인스턴스에서 먼저 사용하는 것이 좋습니다.
환경을 사용하는 이유#
환경을 분리하면 프로덕션에서 실행 중인 워크플로를 깨뜨리지 않고 워크플로를 변경할 수 있습니다. 일반적인 구성은 다음과 같습니다.
- 개발: 워크플로를 빌드하고 변경합니다.
- 프로덕션: 운영 중인 워크플로를 실행합니다.
환경의 동작 방식#

변경 사항은 환경을 통해 인스턴스 사이를 이동합니다.
- 개발 인스턴스에서 변경 사항을 Production 환경으로 프로모트합니다.
- 선택 사항: 변경 사항이 환경에 도달하기 전에 누군가 프로모션 리뷰에서 변경 사항을 승인합니다.
- 프로덕션 인스턴스에서 Production 환경의 변경 사항을 적용합니다.
Git 기반 프로모션에서는 프로모트하면 변경 사항이 Production 환경의 Git 브랜치에 커밋됩니다.
개념#
환경#
개념적으로 환경은 릴리즈 프로세스의 한 단계와 그 단계를 실행하는 인스턴스(스테이징 또는 프로덕션 인스턴스 등)를 합친 것입니다. 변경 사항을 다음 환경으로 프로모트하면 그 환경의 인스턴스가 변경 사항을 적용합니다.
기술적으로 Git 기반 프로모션에서는 프로모트된 변경 사항이 인스턴스가 적용할 때까지 원격 Git 리포지터리의 브랜치에서 대기합니다. 프로모트하는 인스턴스에서는 프로모트 환경 구성이 해당 리포지터리와 브랜치를 가리키며, 기능 브랜치를 푸시하거나 머지 리퀘스트를 여는 등 변경 사항이 브랜치에 도달하는 방식을 정의합니다. 적용하는 인스턴스에서는 적용 환경 구성이 같은 리포지터리와 브랜치를 가리킵니다.
프로모트와 적용#
프로모트와 적용은 두 가지 프로모션 작업입니다.
- 프로모트는 사용자의 인스턴스에서 환경으로 변경 사항을 보냅니다.
- 적용은 환경의 변경 사항을 사용자의 인스턴스로 가져옵니다.
프로모트하는 인스턴스가 소스 인스턴스이고, 적용하는 인스턴스가 타깃 인스턴스입니다.
프로모트와 적용은 두 가지 수준에서 할 수 있습니다.
- 프로젝트: 팀 프로젝트 하나를 프로모트하거나 적용합니다. 포함할 변경 사항을 직접 선택합니다.
- 인스턴스: 인스턴스의 모든 팀 프로젝트를 프로모트하거나 적용합니다.
인스턴스 적용은 인스턴스의 모든 팀 프로젝트를 환경과 일치하도록 덮어씁니다. 환경에 없는 프로젝트도 삭제합니다.
프로모트하는 대상#
워크플로가 프로모션의 기본 단위입니다. 워크플로를 선택하면 n8n이 자격 증명, 변수, 데이터 테이블, 태그 등 해당 워크플로의 의존성을 함께 포함합니다. n8n은 자격 증명 시크릿, 데이터 테이블 행, 실행 기록을 리포지터리에 기록하지 않습니다. 변수는 값과 함께 이동합니다.
프로모트와 적용은 n8n 패키지를 사용해 콘텐츠를 내보내고 가져옵니다. 적용이 인스턴스에서 무엇을 변경하는지는 변경 사항 적용을 참고합니다.
프로모션 모델#
프로모션 모델은 변경 사항이 환경 사이를 이동하는 방식입니다. n8n은 현재 변경 사항이 Git 리포지터리를 통해 이동하는 Git 기반 프로모션을 지원합니다. 한 인스턴스에서 다른 인스턴스로 직접 프로모트하는 등 다른 모델이 이후에 추가될 수 있습니다. Git 기반 프로모션을 참고합니다.
제공자#
제공자는 n8n이 Git 호스트에 연결하고 인증하는 데 사용하는 액세스 토큰이나 SSH 키 같은 세부 정보를 담고 있습니다. 여러 환경이 같은 제공자를 사용할 수 있습니다. 선택한 Git 제공자 유형에 따라 제공자가 접근할 수 있는 리포지터리와 브랜치를 목록으로 보여 주는 등 추가 기능이 달라집니다.
Environments와 Environments (Classic)#
Environments는 이전 소스 컨트롤 기능인 Environments (Classic)를 대체합니다. 한 인스턴스는 둘 중 하나만 사용합니다. Environments (Classic)에서 업그레이드를 참고합니다.
이 섹션의 문서#
- 환경 계획: 인스턴스와 환경을 연결하는 방식을 선택합니다.
- 첫 번째 프로모션: 새 타깃 인스턴스로 작업을 처음 가져옵니다.
- 변경 사항 프로모트: 프로젝트 또는 인스턴스 전체를 환경으로 보냅니다.
- 변경 사항 적용: 환경의 변경 사항을 프로젝트 또는 인스턴스 전체로 가져옵니다.
- 프로덕션 인스턴스 보호: 적용만 하는 인스턴스에서 UI를 통한 변경을 제한합니다.
- 프로모션 리뷰: 프로모트된 변경 사항이 환경의 브랜치에 도달하기 전에 승인합니다.
- Git 기반 프로모션: 환경이 Git을 사용하는 방식과 지원하는 Git 제공자를 설명합니다.
- 알려진 제한 사항: Environments가 아직 지원하지 않는 항목과 우회 방법을 설명합니다.
- Environments (Classic)에서 업그레이드: 두 버전을 비교하고, 인스턴스를 마이그레이션하고, 이전 버전으로 되돌립니다.