Environments (Classic)에서 업그레이드
n8n v2.47요약
Environments는 이전 소스 컨트롤 기능인 Environments (Classic)를 개선하고 대체합니다. Environments는 Preview 상태이며 이후 릴리즈에서 변경될 수 있습니다. Environments는 아직 Environments (Classic)의 모든 기능을 지원하지 않습니다.
Environments는 이전 소스 컨트롤 기능인 Environments (Classic)를 개선하고 대체합니다. 각 인스턴스는 Classic 또는 Environments 중 하나를 사용하며, Environments가 Preview인 동안에는 Classic으로 되돌릴 수 있습니다.
Preview 상태
Environments는 Preview 상태이며 이후 릴리즈에서 변경될 수 있습니다. 프로덕션 인스턴스에 설정하기 전에 테스트 인스턴스에서 먼저 사용해 보십시오.
Classic과 Environments 비교#
| Environments (Classic) | Environments | |
|---|---|---|
| 모델 | 인스턴스가 하나의 브랜치로 푸시하고 그 브랜치에서 풀합니다. | 인스턴스가 한 환경으로 프로모트하고 다른 환경에서 적용합니다. 각 환경은 자체 리포지터리와 브랜치를 사용할 수 있습니다. |
| Git 호스트 | SSH 또는 HTTPS를 지원하는 모든 Git 호스트. | Classic과 마찬가지로 Generic Git을 통한 모든 Git 호스트. GitLab은 리포지터리 및 브랜치 목록을 추가로 제공합니다. |
| 리뷰 | Git 호스트에서 수동으로 진행합니다. | n8n이 GitLab에 여는 머지 리퀘스트를 기반으로, n8n에서 시각적 비교(diff)와 함께 프로모션 리뷰를 진행합니다. |
| 변경 사항 선택 | 푸시할 대상을 직접 선택합니다. 풀은 모든 항목을 가져옵니다. | 프로젝트 프로모트 또는 프로젝트 적용으로 양방향 모두 변경 사항을 선택하거나, 인스턴스 프로모트 또는 인스턴스 적용으로 모든 팀 프로젝트를 이동합니다. |
| 의존성 | 워크플로, 자격 증명, 데이터 테이블을 선택합니다. n8n이 태그와 변수 스텁을 추가합니다. | n8n이 선택한 워크플로가 사용하는 모든 항목을 포함합니다. 의존성을 직접 선택하는 기능은 계획 중입니다. |
| 변경 사항 반영 전 | 확인하면 풀이 로컬 변경 사항을 덮어쓸 수 있습니다. | 적용은 먼저 차단 요소를 확인하고, 파괴적인 변경은 확인을 요청합니다. |
| 자격 증명 | 값이 없는 스텁. | 대상에 존재해야 하며, 그렇지 않으면 적용 중에 생성합니다. |
| 변수 | 값이 없는 스텁. | 값과 함께 리포지터리에 기록됩니다. 대상에 존재해야 하며, 그렇지 않으면 적용 중에 생성합니다. |
| 사용 가능 대상 | 인스턴스 소유자와 관리자. 프로젝트 관리자는 푸시할 수 있습니다. | 인스턴스 소유자와 관리자. 프로젝트 프로모트 및 프로젝트 적용에서 프로젝트 관리자를 지원하는 기능은 계획 중입니다. |
| 개인 프로젝트 | 포함됩니다. | 포함되지 않습니다. |
| 자동화 | 퍼블릭 API의 소스 컨트롤 엔드포인트와 n8n CLI의 풀 명령. | 퍼블릭 API의 프로모션 엔드포인트와 n8n CLI의 프로모션 명령. |
Environments가 아직 지원하지 않는 Classic 기능#
Environments는 아직 Environments (Classic)의 모든 기능을 지원하지 않습니다. 업그레이드하기 전에 다음 항목을 확인하십시오.
- 개인 프로젝트: Classic은 개인 프로젝트를 포함합니다. Environments는 팀 프로젝트만 프로모트합니다.
- 프로젝트 관리자: Classic에서는 프로젝트 관리자가 푸시할 수 있습니다. Environments에서는 인스턴스 소유자와 인스턴스 관리자만 프로모트하고 적용할 수 있습니다. 프로젝트 프로모트 및 프로젝트 적용에서 프로젝트 관리자를 지원하는 기능은 계획 중입니다.
- 자동 게시: Classic은 풀할 때 워크플로를 게시할 수 있습니다. 적용은 워크플로의 게시 여부를 변경하지 않습니다. 자동 게시는 계획 중입니다.
- 인스턴스 색상: Classic에서는 인스턴스의 색상을 설정할 수 있습니다. Environments에는 이 설정이 없습니다.
- 의존성 선택: Classic에서는 자격 증명과 데이터 테이블을 단독으로 푸시할 수 있습니다. Environments는 선택한 워크플로의 모든 의존성을 포함하며, 의존성을 직접 선택할 수 없습니다. 의존성 선택은 계획 중입니다.
- 프로젝트 간 이동: Classic 풀은 워크플로를 Git에서 속한 프로젝트로 이동합니다. 프로젝트 프로모트 또는 프로젝트 적용은 워크플로나 폴더를 프로젝트 간에 이동할 수 없으므로 인스턴스 프로모트와 인스턴스 적용을 사용합니다. 프로젝트 간 워크플로 및 폴더 이동을 참조하십시오.
- 워크플로 설명: Classic은 워크플로 설명을 동기화합니다. Environments는 동기화하지 않습니다.
- 자격 증명 설정: Classic은 자격 증명을 모든 사용자 및 프로젝트와 공유하는지 여부와 각 사용자가 자신의 계정을 연결하는지 여부를 동기화합니다. Environments는 동기화하지 않으므로 대상 인스턴스에서 이 옵션을 다시 설정합니다.
Environments에는 Classic과 관련이 없는 제한 사항도 있습니다. 알려진 제한 사항을 참조하십시오.
Environments (Classic)에서 마이그레이션#
Classic과 Environments는 Git에 콘텐츠를 저장하는 형식이 서로 달라서, 적용은 Classic이 푸시한 내용을 읽을 수 없습니다. Environments가 기술적으로는 Classic 콘텐츠가 있는 리포지터리를 공유할 수 있지만, n8n은 새 리포지터리나 비어 있는 브랜치를 사용할 것을 권장합니다.
먼저 테스트 인스턴스에서 시도하십시오. Classic 설정은 백그라운드에서 계속 연결되어 있으므로 되돌릴 수 있습니다.
시작하기 전에 다음을 수행합니다.
- 퍼블릭 API의 Classic 엔드포인트를 호출하는 CI 파이프라인을 프로모션 엔드포인트로 전환합니다. 업그레이드는 UI만 변경하므로 해당 엔드포인트는 계속 Classic 푸시와 풀을 실행합니다. n8n은 Environments를 사용하는 인스턴스에서 이 엔드포인트를 차단할 계획입니다.
- 개발과 프로덕션 등 모든 인스턴스에서 Settings > **Environments (Classic)**으로 이동하여 Upgrade를 선택하고 확인합니다.
- Production 환경용 새 리포지터리 또는 비어 있는 브랜치를 만듭니다.
- 개발 및 프로덕션과 같이 환경 구성을 추가합니다. 브랜치가 비어 있는 동안에는 프로덕션에서 적용하지 않습니다.
그런 다음 다음 두 가지 방법 중 하나로 브랜치를 채웁니다.
개발에서 시작#
개발에 프로덕션으로 가져올 준비가 되지 않은 변경 사항이 없다면 첫 번째 프로모션의 3단계부터 따릅니다.
프로덕션에서 시작#
개발에 프로덕션으로 가져올 준비가 되지 않은 변경 사항이 있다면 대신 프로덕션에서 브랜치를 채웁니다. 그러면 브랜치가 프로덕션과 일치하게 되며, 변경 사항이 준비되었을 때 개발에서 프로모트합니다.

- 프로덕션에서 같은 리포지터리와 브랜치를 가리키는 Production 프로모트 환경 구성을 추가하고 인스턴스 프로모트를 실행합니다. 그런 다음 프로덕션에서 프로모트 환경 구성을 제거합니다.
- 이후에는 변경 사항이 준비되면 개발에서 프로젝트 프로모트로 프로모트합니다. 인스턴스 프로모트는 준비되지 않은 변경 사항까지 함께 보냅니다.
- 프로덕션에서 변경 사항을 적용합니다.
두 경우 모두 Classic 풀이 원본의 ID를 유지했으므로, 적용은 프로덕션의 콘텐츠를 그 자리에서 업데이트합니다. 워크플로는 버전 이력과 실행 기록을 유지하고, 변수는 값을 유지하며, 자격 증명은 시크릿을 유지합니다. 완료되면 프로덕션 인스턴스를 보호합니다.
Environments (Classic)로 되돌리기#
- Settings > Environments로 이동합니다.
- Switch back을 선택한 다음 확인합니다.
되돌리기는 해당 인스턴스에만 영향을 줍니다. 언제든지 다시 업그레이드할 수 있습니다.