CLI commands for n8n
n8n에는 CLI(명령줄 인터페이스)가 포함되어 있어 n8n 편집기가 아닌 CLI를 사용하여 작업을 수행할 수 있습니다. 여기에는 워크플로우 시작, 워크플로우 및 자격 증명 내보내기 및 가져오기가 포함됩니다.
CLI 명령 실행
자체 호스팅된 n8n과 함께 CLI 명령을 사용할 수 있습니다. n8n을 설치하는 방법에 따라 명령어를 실행하는 방법에 차이가 있습니다:
•
npm: n8n
명령을 직접 사용할 수 있습니다. 이 설명서는 아래 예제에서 이 기능을 사용합니다.
•
도커: n8n
명령은 도커 컨테이너 내에서 사용할 수 있습니다:
docker exec -u node -it <n8n-container-name> <n8n-cli-command>
워크플로 시작
•
CLI를 사용하여 직접 워크플로우를 시작할 수 있습니다. 저장된 워크플로를 ID별로 실행합니다:
•
워크플로우 ID는 URL에서 확인가능.
n8n execute --id <ID>
n8n execute --id NGgtX67xWcwx2a3I
•
아래 도커에서 Exec에 바로 입력해서 실행가능.
워크플로의 활성 상태 변경
CLI를 사용하여 워크플로의 활성 상태를 변경할 수 있습니다.
재시작 필요
이 명령은 n8n 데이터베이스에서 작동합니다. n8n이 실행되는 동안 이를 실행하면 n8n을 다시 시작할 때까지 변경 사항이 적용되지 않습니다.
워크플로의 ID별 활성 상태를 거짓으로 설정합니다:
n8n update:workflow --id=<ID> --active=false워크플로의 ID별 활성 상태를 true로 설정합니다:
n8n update:workflow --id=<ID> --active=true모든 워크플로에 대해 활성 상태를 거짓으로 설정합니다:
n8n update:workflow --all --active=false모든 워크플로에 대해 활성 상태를 true로 설정합니다:
n8n update:workflow --all --active=true워크플로 및 자격 증명 내보내기
CLI를 사용하여 n8n에서 워크플로와 자격 증명을 내보낼 수 있습니다.
명령 플래그:
Flag | Description |
--help | Help prompt. |
--all | Exports all workflows/credentials. |
--backup | Sets --all --pretty --separate for backups. You can optionally set --output. |
--id | The ID of the workflow to export. |
--output | Outputs file name or directory if using separate files. |
--pretty | Formats the output in an easier to read fashion. |
--separate | Exports one file per workflow (useful for versioning). Must set a directory using --output. |
--decrypted | Exports the credentials in a plain text format. |
워크플로
모든 워크플로를 표준 출력(터미널)으로 내보냅니다:
n8n export:workflow --all워크플로를 ID별로 내보내고 출력 파일 이름을 지정합니다:
n8n export:workflow --id=<ID> --output=file.json모든 워크플로를 단일 파일의 특정 디렉토리로 내보냅니다:
n8n export:workflow --all --output=backups/latest/file.json를 사용하여 모든 워크플로를 특정 디렉토리로 내보냅니다. --backup 플래그(위 details):
n8n export:workflow --backup --output=backups/latest/자격 증명
모든 자격 증명을 표준 출력(터미널)으로 내보냅니다:
n8n export:credentials --allID별로 자격 증명을 내보내고 출력 파일 이름을 지정합니다:
n8n export:credentials --id=<ID> --output=file.json단일 파일의 모든 자격 증명을 특정 디렉토리로 내보냅니다:
n8n export:credentials --all --output=backups/latest/file.json를 사용하여 모든 자격 증명을 특정 디렉토리로 내보냅니다. --backup 플래그(위 details):
n8n export:credentials --backup --output=backups/latest/모든 자격 증명을 일반 텍스트 형식으로 내보냅니다. 이를 사용하여 구성 파일에 다른 비밀 키가 있는 설치에서 다른 설치로 마이그레이션할 수 있습니다.
•
민감한 정보
◦
모든 민감한 정보는 파일에서 확인할 수 있습니다.
n8n export:credentials --all --decrypted --output=backups/decrypted.json워크플로 및 자격 증명 가져오기
CLI를 사용하여 n8n에서 워크플로와 자격 증명을 가져올 수 있습니다.
ID 업데이트
워크플로 및 자격 증명을 내보낼 때 n8n은 ID도 내보냅니다. 기존 데이터베이스에 동일한 ID를 가진 워크플로와 자격 증명이 있는 경우 덮어쓰기됩니다. 이를 방지하려면 가져오기 전에 ID를 삭제하거나 변경합니다.
사용 가능한 플래그:
Flag | Description |
--help | Help prompt. |
--input | Input file name or directory if you use --separate. |
--projectId | Import the workflow or credential to the specified project. Can't be used with --userId. |
--separate | Imports *.json files from directory provided by --input. |
--userId | Import the workflow or credential to the specified user. Can't be used with --projectId. |
SQLite로 마이그레이션
n8n은 워크플로 및 자격 증명 이름을 128자로 제한하지만 SQLite는 크기 제한을 적용하지 않습니다.
이 경우 가져오기 프로세스 중에 열 이름에 비해 데이터가 너무 길어지는 등의 오류가 발생할 수 있습니다.
이 경우 n8n 인터페이스에서 이름을 편집하고 다시 내보내거나 가져오기 전에 JSON 파일을 직접 편집할 수 있습니다.
워크플로
특정 파일에서 워크플로 가져오기:
n8n import:workflow --input=file.json지정한 디렉토리에서 모든 워크플로 파일을 JSON으로 가져옵니다:
n8n import:workflow --separate --input=backups/latest/자격 증명
특정 파일에서 자격 증명 가져오기:
n8n import:credentials --input=file.json지정한 디렉토리에서 모든 자격 증명 파일을 JSON으로 가져옵니다:
n8n import:credentials --separate --input=backups/latest/라이선스
지우기
n8n의 데이터베이스에서 기존 라이선스를 삭제하고 n8n을 기본 기능으로 재설정합니다:
n8n license:clear정보
기존 라이선스에 대한 정보를 표시합니다:
n8n license:info사용자 관리
n8n CLI를 사용하여 사용자 관리를 재설정할 수 있습니다. 이렇게 하면 사용자 관리가 사전 설정 상태로 돌아갑니다. 모든 사용자 계정을 제거합니다.
비밀번호를 잊어버리고 이메일로 비밀번호 재설정을 수행하도록 SMTP가 설정되어 있지 않은 경우 이 방법을 사용합니다.
n8n user-management:reset사용자에 대한 MFA 비활성화
사용자가 복구 코드를 분실한 경우 이 명령으로 사용자의 MFA를 비활성화할 수 있습니다. 그러면 사용자가 다시 로그인하여 MFA를 다시 설정할 수 있습니다.
n8n mfa:disable --email=johndoe@example.comLDAP 사용 안 함
아래 명령을 사용하여 LDAP 설정을 재설정할 수 있습니다.
n8n ldap:reset보안 감사
n8n auditWorkflow Postgres DB 접속
•
데이터베이스 구조는 여기에서 확인 가능합니다.
•
docker-compose.yml 파일로 실행된 Postgres에 접속하려면 다음과 같은 방법을 사용할 수 있습니다.
•
iterm2 같은 별도 터미널에서 실행하려면, 우측 “Open in external terminal” 을 누르시면 됩니다.
•
/# 으로 나오면 컨테이너 내부 셀에 접속한 것.
•
컨테이너 내부에서 Postgres 데이터베이스에 접속하려면 psql 명령어를 사용해야 합니다. psql 명령어를 사용하려면 다음과 같이 입력하세요:
◦
<username>: docker-compose.yml에서 설정한 POSTGRES_USER.
◦
<database>: docker-compose.yml에서 설정한 POSTGRES_DB.
psql -U <username> -d <database>•
docker-compose.yml에 초기 설정값은 다음과 같습니다.
◦
POSTGRES_USER=root
POSTGRES_PASSWORD=password
POSTGRES_DB=n8n
POSTGRES_PASSWORD=password
POSTGRES_DB=n8n
•
해서, psql -U root -d n8n 으로 입력하시면 됩니다.
•
\dt 명령어는 현재 데이터베이스의 테이블 목록을 보여줍니다.
1. 테이블의 구조 확인하기
•
특정 테이블의 구조(컬럼 정보, 데이터 타입 등)를 확인하려면 \d <table_name>을 사용합니다.
•
\d user
1.
테이블의 데이터 조회하기
•
테이블의 데이터를 조회하려면 일반적인 SQL 쿼리를 사용하면 됩니다. 예를 들어 user 테이블에서 모든 데이터를 가져오려면:
•
SELECT * FROM user;
1.
추가, 수정, 삭제
a.
INSERT INTO user (id, name, email) VALUES (1, 'Alice', 'alice@example.com');
b.
UPDATE user SET name = 'Bob' WHERE id = 1;
c.
DELETE FROM user WHERE id = 1;
2.
셸 나가기
•
\q 로 종료합니다.