XEIZE
/Integrations/XEIZE OnPrem/프로젝트 등록 및 실행/Manual Upload

Manual Upload

Manual Upload는 Git 연동 없이 컴퓨터에 있는 폴더나 ZIP 파일로 프로젝트를 등록하는 기능입니다.

필요한 역할

Manual Upload로 새 프로젝트를 등록하려면 Super Admin으로 로그인해야 합니다.

진입 방법

아래 경로 중 하나에서 Upload Project 화면을 엽니다.

  • Integrations > Manual Upload > Connect
  • Projects > Overview > New Project > Manual

업로드 방식

방식 동작
Directory 선택한 폴더에서 제외할 파일을 뺀 뒤 ZIP 파일로 만들어 업로드
Zip File 미리 준비한 ZIP 파일을 그대로 업로드

Directory 탭이 기본으로 열립니다. Zip File에서는 500MB 이하의 ZIP 파일을 사용할 수 있습니다. Directory에서는 제외 규칙을 적용한 뒤 남은 파일의 압축 전 크기 합계가 500MB를 넘지 않아야 합니다.

디렉터리 업로드

  1. Integrations > Manual Upload에서 Upload Project 화면을 엽니다.
  2. Directory 탭을 선택합니다.
  3. Project Directory 영역을 선택해 업로드할 폴더를 지정합니다. 지원되는 브라우저에서는 폴더를 끌어 놓을 수도 있습니다.
  4. Project Name을 확인합니다. 최상위 폴더 이름이 자동으로 입력되며 수정할 수 있습니다.
  5. 필요한 경우 Environment labels에서 프로젝트를 구분할 환경 라벨을 선택합니다.
  6. 공개 범위 스위치를 조작해 Public 또는 Private를 정합니다.
  7. 선택된 파일 이름과 압축 전 총 크기를 확인합니다.
  8. Upload Project를 선택합니다.
  9. 브라우저 압축과 업로드가 완료될 때까지 페이지를 닫지 않습니다.

프로젝트 이름은 1자 이상 100자 이하로 입력합니다.

화면에 Private로 표시되더라도 스위치를 조작하지 않으면 Public으로 저장될 수 있습니다. 업로드 전에 반드시 공개 범위 스위치를 조작합니다. Private로 등록하려면 스위치를 켰다가 다시 끕니다.

디렉터리에서 제외되는 항목

디렉터리를 선택하면 .gitignore 파일에 적힌 제외 규칙을 적용합니다. 개발 도구가 자동으로 만드는 파일과 민감한 설정 파일도 기본으로 제외합니다.

  • .git, .next, node_modules
  • dist, build, out, coverage
  • .idea, .vscode, __pycache__
  • .DS_Store, Thumbs.db
  • .env, .env.local, .env.development, .env.test, .env.production
  • *.log

제외 규칙으로 모든 파일이 빠지면 업로드할 수 없습니다. 업로드 전에 필요한 소스와 설정 파일이 남아 있는지 확인합니다.

기본 제외 목록만으로 모든 민감 파일을 걸러낼 수는 없습니다. 비밀 키, 인증서, 운영 데이터가 포함되지 않았는지 직접 확인합니다.

ZIP 파일 업로드

  1. Zip File 탭을 선택합니다.
  2. Project Name을 입력합니다.
  3. 필요한 경우 환경 라벨을 선택합니다.
  4. 공개 범위 스위치를 조작해 Public 또는 Private를 정합니다.
  5. Project File 영역에 프로젝트 소스가 들어 있는 ZIP 파일을 끌어 놓거나 클릭해 선택합니다.
  6. 파일이 500MB 이하인지 확인합니다.
  7. Upload Project를 선택합니다.

ZIP 파일만 업로드할 수 있습니다. ZIP 안에 불필요한 빌드 결과나 민감 파일이 없는지 업로드 전에 확인합니다.

업로드 직후 스캔

프로젝트가 생성되면 Choose Scanner 창이 열립니다.

  • 바로 스캔하려면 스캔 종류를 한 개 이상 선택한 뒤 Scan을 선택합니다.
  • 나중에 스캔하려면 Skip Scan을 선택합니다.
  • 완료 후 Projects > Overview로 이동합니다.

창을 닫아도 프로젝트는 등록된 상태로 남지만 Projects로 이동하지 않습니다. Scan 또는 Skip Scan을 선택하면 Projects로 이동합니다.

Skip Scan을 선택해도 스캔 시작 메시지가 표시될 수 있지만 새 작업은 생성되지 않습니다. 기존 스캔 상태는 Projects의 Scan 열이나 Jobs에서 확인합니다.

업로드한 소스 갱신

Manual Upload 프로젝트에서 기존에 업로드한 ZIP 파일을 교체하려면 Admin 또는 Super Admin 권한이 필요합니다.

  1. Projects > Overview에서 프로젝트 행을 선택합니다.
  2. 프로젝트 상세 창에서 Source 탭을 선택합니다.
  3. 새 ZIP 파일을 Update Project Source 영역에 끌어 놓거나 클릭해 선택합니다.
  4. Update Source를 선택합니다.
  5. 소스 업데이트 성공 메시지와 새 스캔 작업 생성 여부를 확인합니다.

Update Project Source 화면에는 최대 크기가 500MB로 안내됩니다. 파일이 선택되더라도 업로드 전에 500MB 이하인지 확인합니다.

문제 해결

ZIP 파일을 선택할 수 없음

  • 파일 확장자가 .zip인지 확인합니다.
  • 파일 크기가 500MB 이하인지 확인합니다.
  • 브라우저에서 파일 선택 권한이 차단되지 않았는지 확인합니다.

디렉터리를 선택했지만 유효한 파일이 없음

  • .gitignore 파일과 기본 제외 목록이 모든 파일을 제외하고 있지 않은지 확인합니다.
  • 소스가 들어 있는 상위 디렉터리를 다시 선택합니다.

압축 또는 업로드 실패

  • 한 번에 업로드하는 파일 수와 크기를 줄여 다시 시도합니다.
  • 네트워크 연결을 확인합니다.
  • 필요하면 컴퓨터에서 ZIP 파일을 만든 뒤 Zip File 방식으로 다시 시도합니다.
XEIZE Documentation기술 지원