콘텐츠로 건너뛰기
GitTree
CI/CD 파이프라인

로컬에서 파이프라인 실행

GitTree는 워크플로 파일이나 작업 하나에 대한 정확한 act 또는 gitlab-ci-local 명령을 준비하고 이를 실행할 새 터미널에 입력합니다. 작업은 푸시하기 전에 컴퓨터의 Docker 컨테이너에서 실행됩니다. 로컬 파이프라인은 무료 플랜의 일부이며 호스팅 계정이 필요하지 않습니다.

무료업데이트됨

GitTree 무료로 작동합니다. 모든 로컬 Git 기능은 계정이 필요하지 않습니다.

이 페이지에서
  1. 시작하기 전에
  2. 어디서 찾을 수 있나요?
  3. 단계
  4. 예상되는 결과
  5. Docker 및 실행기를 설치합니다.
  6. 샘플 파일
  7. Bitbucket Pipelines 및 Azure Pipelines
  8. 로컬 실행이 호스트와 다른 점
  9. 뭔가 잘못되면
  10. 질문
  11. 관련된

시작하기 전에

  • Docker, 실행 중: Docker Desktop, OrbStack, Colima 또는 Docker Engine. 두 러너 모두 컨테이너에서 모든 작업을 시작합니다.
  • 파일 실행기: GitHub Actions(.github/workflows/*.yml)의 경우 act, GitLab CI(.gitlab-ci.yml)의 경우 gitlab-ci-local. 저장소 외부의 PATH 폴더에 설치합니다.
  • 신뢰할 수 있는 저장소(repository trust): 로컬 실행은 저장소의 코드를 실행합니다.
  • 지원되는 터미널 셸: macOS의 bash, zsh, sh 또는 fish Windows의 PowerShell; Linux의 bash, zsh, sh 또는 fish.

어디서 찾을 수 있나요?

  • 툴바의 CI/CD 버튼: 연결된 계정이나 Pro가 없으면 Local pipelines에서 보기가 열립니다.
  • 왼쪽 패널의 TOOLS 섹션: Prepare local pipeline.
  • 도구 모음(Terminal 옆)의 Tools 또는 저장소 탭의 메뉴: Prepare local pipeline…, 명령 팔레트 또는 Alt+Shift+L 사용.
액션macOSWindows 및 Linux
명령 팔레트, 그 다음 Prepare local pipeline…⌘⇧PCtrl+Shift+P
Show CI/CD⌥PAlt+P

단계

  1. 필요한 것을 확인하세요

    CI/CD을(를) 엽니다. Local pipelines는 What you need: Docker, act 및 gitlab-ci-local를 Found 또는 Not found와 함께 나열하고 각 항목이 발견된 위치, 저장소의 신뢰 및 터미널 셸을 나열합니다. 누락된 프로그램은 설치 방법을 보여줍니다. 설치한 다음 Check again를 누르세요. Ask Nour to Set Up the Local Runner은(는) 현재 누구나 무료로 사용할 수 있는 Pro의 일부입니다. 명령을 로컬로 준비하고 실행하는 것은 그렇지 않습니다.

    Docker 및 행위가 발견되었지만 gitlab-ci-local을(를) 찾을 수 없는 로컬 파이프라인의 CI/CD 보기
    로컬 파이프라인은 무료로 표시됩니다. 그 위의 호스팅 실행에는 여전히 연결된 계정이 필요합니다.데모 저장소와의 GitTree 인터페이스입니다.

  2. 파이프라인 파일을 추가하거나 직접 사용하세요.

    Pipeline files in this repository에는 Ready to run 또는 실행할 수 없는 이유가 포함된 각 파일이 나열됩니다. 아직 파일이 없으면 Add GitHub Actions sample는 .github/workflows/gittree-local.yml을 쓰고 Add GitLab CI sample는 .gitlab-ci.yml를 씁니다. 각각 주석이 달린 두 개의 작업이 있습니다. GitTree은 기존 파일 위에 쓰지 않습니다. 파일이 편집기에서 열립니다. 여기에 빌드 및 테스트 명령을 입력하세요.

  3. 명령을 준비하세요

    Run Locally…를 누르세요. Prepare local pipeline에서 Pipeline config, Job 또는 Runner default jobs를 선택하고 Terminal shell를 선택한 다음 Prepare command를 선택합니다. 아직 아무것도 실행되지 않습니다.

  4. 터미널에서 실행하세요

    Prepared command을 읽은 다음 Type in new terminal을 읽습니다. GitTree가 새 터미널에 입력하고 Enter 키를 누르지 않습니다. 직접 검토하고 Enter 키를 누르세요. 작업의 출력이 터미널에 나타납니다.

예상되는 결과

실행기는 처음으로 작업 이미지를 가져온 다음 컨테이너에서 각 단계를 실행하고 그 결과를 터미널에 인쇄합니다. 저장소의 파일은 커밋 여부에 관계없이 디스크에 있는 그대로 사용됩니다.

Docker 및 실행기를 설치합니다.

각 시스템에 설치할 항목
프로그램macOSWindowsLinux
DockerDocker Desktop, OrbStack 또는 ColimaDocker DesktopDocker Engine 또는 Docker Desktop
행위(GitHub Actions)brew install actwinget install nektos.actnektosact.com의 설치 스크립트
gitlab-ci-local (GitLab CI)npm install -g gitlab-ci-localPATH 폴더에 있는 GitHub 릴리스의 .exenpm install -g gitlab-ci-local

npm으로 설치하려면 gitlab-ci-local에 Node.js 18 이상이 필요합니다. GitTree은 PATH에서만 프로그램을 찾습니다. 확인하기 위해 실행하지 않으므로 Docker 엔진이 시작되었는지 알 수 없습니다.

샘플 파일

GitHub Actions 샘플은 build 작업을 실행한 다음 ubuntu-latest에서 test 작업을 실행합니다. 첫 번째 실행 시 어떤 실행기 이미지를 사용할지 묻습니다. Medium는 대부분의 프로젝트에 적합합니다. GitLab CI 샘플은 alpine 컨테이너에서 동일한 두 작업을 실행합니다. echo 줄을 자신의 명령으로 바꾼 다음 파일이 준비되면 커밋합니다. 저장소가 GitHub 또는 GitLab에 있는 경우 해당 호스트도 파일을 실행합니다.

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build
        run: npm ci && npm run build
  test:
    runs-on: ubuntu-latest
    needs: build
    steps:
      - uses: actions/checkout@v4
      - name: Test
        run: npm test

Bitbucket Pipelines 및 Azure Pipelines

bitbucket-pipelines.yml 또는 azure-pipelines.yml에 대해 지원되는 로컬 실행기가 없으므로 해당 파일에는 No local runner이 표시됩니다. 컴퓨터에서 동일한 단계를 실행하려면 GitHub Actions 또는 GitLab CI 샘플을 추가하고 여기에 명령을 복사하세요. 호스팅된 파이프라인은 자체 파일에서 계속 실행됩니다.

로컬 실행이 호스트와 다른 점

  • 호스트에 설정된 비밀 및 변수는 사용할 수 없습니다. 작업에 필요한 것을 러너에게 직접 전달하십시오.
  • act는 기본적으로 푸시 트리거 작업을 실행합니다. 트리거에 관계없이 실행하려면 Job을(를) 선택하세요.
  • GitTree이 작업을 나열할 때 포함, 템플릿 및 재사용 가능한 워크플로가 해결되지 않습니다. 러너는 실행될 때 이를 해결합니다.
  • 컨테이너는 귀하의 네트워크에 도달하여 귀하가 제공한 자격 증명을 사용할 수 있습니다.

뭔가 잘못되면

"PATH에서 안전한 기본 실행기를 찾을 수 없습니다. 저장소 외부에 설치한 다음 새로 고치세요."

저장소 내부가 아닌 PATH의 폴더에 act 또는 gitlab-ci-local를 설치한 다음 Check again 또는 Refresh를 누릅니다. macOS에서 쉘 프로필의 PATH를 변경한 경우 종료하고 GitTree를 다시 엽니다.

"이 공급자 구성에는 지원되는 로컬 실행기가 없습니다."

파일은 Bitbucket 또는 Azure 파이프라인입니다. GitHub Actions 또는 GitLab CI 샘플을 추가하고 단계를 복사하세요.

"로컬 파이프라인 명령을 준비하기 전에 이 저장소를 신뢰하십시오."

먼저 저장소를 신뢰한 후(저장소 신뢰) 명령을 다시 준비하십시오.

터미널에 Docker 데몬에 연결할 수 없다고 표시됩니다.

Docker Desktop, OrbStack, Colima 또는 Docker 서비스를 시작하고 실행될 때까지 기다린 후 명령에서 Enter를 다시 누르십시오.

질문

로컬 파이프라인에는 GitTree Pro 또는 호스팅 계정이 필요합니까?

아니요. 로컬 파이프라인은 무료 플랜의 일부이며 저장소의 파일만 읽습니다. 호스팅된 CI/CD 실행, 재실행 및 승인은 Pro의 일부입니다.

GitTree가 나를 위해 파이프라인을 실행합니까?

아니요. GitTree는 명령을 준비하여 터미널에 입력합니다. Enter를 누르세요. 당신이 하기 전에는 아무것도 실행되지 않습니다.

관련된