변경 사항 적용
n8n v2.47요약
변경 사항을 적용하면 환경의 작업 내용이 인스턴스로 반영됩니다. 환경은 프리뷰 상태이며 향후 릴리즈에서 변경될 수 있습니다. 시작하기 전에 이 인스턴스가 변경 사항을 적용할 환경을 추가하세요. 프로젝트 적용을 하려면 인스턴스에 해당 프로젝트가 있어야 합니다.
변경 사항을 적용하면 환경의 작업 내용이 인스턴스로 반영됩니다. 프로젝트 적용은 선택한 변경 사항을 하나의 팀 프로젝트에 가져옵니다. 인스턴스 적용은 인스턴스 전체를 환경과 일치시킵니다.
프리뷰 상태
환경은 프리뷰 상태이며 향후 릴리즈에서 변경될 수 있습니다. 프로덕션 인스턴스에 설정하기 전에 테스트 인스턴스에서 먼저 사용해 보세요.
시작하기 전에 이 인스턴스가 변경 사항을 적용할 환경을 추가하세요. 환경 계획하기를 참조하세요.
누락된 프로젝트 추가#
프로젝트 적용을 하려면 인스턴스에 해당 프로젝트가 있어야 합니다. 환경의 브랜치에 아직 이 인스턴스에 없는 팀 프로젝트가 있다면 먼저 추가하세요.
- Settings > Environments로 이동합니다.
- Apply changes from 아래의 환경에서 Apply 옆의 Add N missing projects를 선택합니다.
- 추가할 프로젝트를 선택합니다. 선택 사항: Assign a project admin 아래에서 각 프로젝트의 사용자를 선택합니다.
- Add N missing projects를 확인합니다.
n8n은 소스의 ID, 이름, 아이콘, 설명을 가진 빈 프로젝트를 생성합니다. 콘텐츠는 적용하지 않습니다. 브랜치에 워크플로가 있는 프로젝트라면 프로젝트를 열어 프로젝트 적용을 실행하세요.
이러한 프로젝트를 직접 생성하지 마세요. 직접 생성한 프로젝트는 ID가 다르므로 이름이 같더라도 Apply가 일치시키지 못하며, 프로젝트는 계속 누락된 것으로 표시됩니다.
프로젝트 적용#
프로젝트 적용은 선택한 변경 사항을 하나의 팀 프로젝트에 가져옵니다. 프로젝트가 소스의 ID로 인스턴스에 존재해야 합니다. 누락된 프로젝트 추가를 참조하세요. 프로젝트 적용은 프로젝트를 삭제하지 않습니다. 인스턴스의 모든 프로젝트는 태그를 공유하므로, 태그 이름 변경은 모든 프로젝트에 적용됩니다.
- 팀 프로젝트를 엽니다. 프로젝트 이름 옆에 아래쪽 화살표가 있는 배지가 들어오는 변경 사항의 수를 표시합니다.
- 배지를 선택합니다. Changes to apply 페이지가 열립니다.
- 적용할 워크플로를 선택합니다. n8n은 자격 증명, 변수, 데이터 테이블, 태그 같은 종속 항목을 함께 포함합니다.
- 변경 사항을 검토합니다. 각 리소스에는 New, Modified, Renamed, Moved, Archived, Deleted 같은 변경 내용이 표시됩니다. 워크플로를 시각적으로 비교하려면 Show diff를 선택하세요. diff 뷰어는 캔버스의 Before와 After를 보여 주며, Before는 이 인스턴스, After는 환경의 브랜치입니다.
- Blockers 탭을 확인하고 차단 항목이 있으면 해결합니다. 차단 항목 해결을 참조하세요.
- Apply N changes를 선택한 다음 확인합니다.
차단 항목 해결#
Apply가 무언가를 쓰기 전에 n8n은 변경 사항을 인스턴스와 대조해 확인합니다. 이 확인은 프로젝트 적용과 인스턴스 적용 모두에서 이루어집니다. 차단 항목이 있으면 해결할 때까지 Apply가 중단되며, 차단 항목이 남아 있는 동안 Apply는 아무것도 변경하지 않습니다.
| 차단 항목 | 해결 방법 |
|---|---|
| Missing 자격 증명 또는 변수 | Add credential 또는 Add variable을 선택하여 생성합니다. 자격 증명의 경우 n8n이 소스에서 표현식을 사용하는 필드를 미리 채웁니다. 변수의 경우 n8n이 소스의 값을 미리 채웁니다. 다른 프로젝트가 소유한 자격 증명은 대신 충돌로 표시됩니다. 프로젝트 간 종속성을 참조하세요. |
| No access | 자격 증명은 존재하지만 프로젝트가 사용할 수 없습니다. 관리자에게 해당 프로젝트와 공유해 달라고 요청하세요. |
| Conflict | 인스턴스의 리소스가 Apply로 해결할 수 없는 방식으로 다릅니다. 메시지를 따른 다음 새로 고침하세요. |
| Moved | 워크플로 또는 폴더가 브랜치의 다른 프로젝트에 있습니다. 프로젝트 적용은 프로젝트 간에 항목을 이동할 수 없습니다. 브랜치와 일치하도록 인스턴스에서 이동하거나 인스턴스 적용을 실행하세요. |
파괴적 변경 확인#
Apply는 다음 작업을 하기 전에 확인을 요청합니다.
- 데이터 테이블 칼럼을 제거하거나 유형을 변경하는 경우. 해당 칼럼의 값이 삭제됩니다. 행과 다른 칼럼은 그대로 유지됩니다.
- 인스턴스 적용에서 프로젝트를 삭제하는 경우.
인스턴스 적용#
인스턴스 적용은 모든 프로젝트를 환경의 브랜치와 일치하도록 덮어씁니다. 브랜치에 없는 프로젝트와 콘텐츠는 삭제됩니다. 이 작업은 되돌릴 수 없습니다. 소스에서 인스턴스 프로모션을 수행한 뒤에, 또는 인스턴스를 백업한 뒤에만 실행하세요.
인스턴스 적용은 인스턴스를 환경과 완전히 일치시킬 때 사용합니다. 예를 들어 새 프로덕션 인스턴스를 초기 구성할 때 사용합니다. 일상적인 변경에는 더 세밀하게 제어할 수 있는 프로젝트 적용을 권장합니다.
- Settings > Environments로 이동합니다.
- Apply changes from 아래의 환경에서 Apply를 선택합니다.
- 경고를 읽고 Apply를 선택합니다.
- n8n이 차단 항목이나 파괴적 변경을 발견하면 대화 상자를 엽니다. 차단 항목을 해결하고 변경 사항을 검토한 다음 확인하세요. 브랜치에 없는 프로젝트를 삭제하려면 Delete N projects and apply를 확인하세요.
Apply가 인스턴스에서 변경하는 내용#
Apply는 워크플로, 폴더, 데이터 테이블 스키마 같은 작업의 구조를 가져옵니다. 자격 증명의 실제 시크릿이나 데이터 테이블 행 같은 저장된 콘텐츠는 가져오지 않습니다. 에이전트는 아직 포함되지 않습니다.
| 리소스 | Apply 동작 |
|---|---|
| 프로젝트 | 인스턴스 적용은 브랜치에 있는 프로젝트를 생성하고, 확인 후 브랜치에 없는 프로젝트를 삭제합니다. 프로젝트 적용은 프로젝트를 생성하거나 삭제하지 않습니다. 누락된 프로젝트를 추가하려면 누락된 프로젝트 추가를 참조하세요. |
| 폴더 | 프로젝트 내에서 폴더를 브랜치와 일치하도록 생성, 이름 변경, 이동합니다. 프로젝트 적용은 선택한 워크플로가 들어 있는 폴더만 변경합니다. |
| 워크플로 | 생성하거나 업데이트합니다. 소스에서 워크플로를 삭제한 경우, Apply는 인스턴스에서 해당 워크플로를 보관하지 않고 삭제합니다. 보관된 워크플로는 보관된 상태로 유지됩니다. Apply는 워크플로의 게시 여부를 변경하지 않습니다. Apply가 생성한 워크플로는 게시되지 않은 상태로 도착하므로 인스턴스에서 게시하세요. |
| 자격 증명 | 워크플로를 같은 ID의 자격 증명에 연결합니다. 자격 증명이 없으면 차단 항목을 해결하는 동안 생성합니다. 자격 증명이 있고 프로젝트에 속해 있으면, Apply는 이름과 표현식을 사용하는 필드를 업데이트하고 시크릿 같은 다른 모든 값은 그대로 유지합니다. |
| 변수 | 변수가 인스턴스에 존재해야 하며, 없으면 차단 항목을 해결하는 동안 소스의 값을 미리 채워서 생성합니다. Apply는 기존 변수의 값을 변경하지 않습니다. |
| 데이터 테이블 | 테이블을 생성하거나 스키마를 업데이트합니다. 기존 행은 유지됩니다. 칼럼을 제거하거나 유형을 변경하면 확인 후 해당 칼럼의 값만 삭제됩니다. |
| 태그 | 태그를 생성하고 브랜치와 일치하도록 이름을 변경합니다. Apply는 태그를 삭제하지 않습니다. |
Apply는 인스턴스의 콘텐츠를 다음과 같이 일치시킵니다.
- ID 기준: 프로젝트, 워크플로, 자격 증명, 데이터 테이블.
- 이름과 범위 기준: 변수.
- ID 기준, 이후 이름 기준: 태그.
프로모션과 적용은 n8n 패키지를 사용하여 이 콘텐츠를 내보내고 가져옵니다.
Apply가 중단되는 경우#
브랜치가 변경됨#
변경 사항을 불러온 뒤 누군가 환경의 브랜치를 변경하면, Apply는 아무것도 쓰기 전에 중단됩니다. 프로젝트 적용은 **The branch changed after the page loaded, so Apply didn't change anything.**을 표시합니다. 인스턴스 적용은 Apply paused를 표시합니다. 최신 변경 사항을 확인한 다음 다시 적용하세요.
적용할 수 없음#
인스턴스 적용이 실패하면 n8n은 Couldn't apply to the instance와 Some changes may already be applied를 표시합니다. n8n은 이미 수행한 변경을 롤백하지 않습니다. Apply는 인스턴스를 브랜치와 일치시키므로 다시 실행하여 마무리할 수 있습니다.
프로젝트 적용이 실패하면 n8n은 Couldn't apply the changes와 다음 중 하나를 표시합니다.
- Nothing changed: 메시지에 표시된 원인을 해결한 다음 다시 시도하세요.
- The request may have run: 페이지에 최신 변경 사항이 표시됩니다. 다시 적용하기 전에 확인하세요.