GitHub Actions Importer를 사용하여 GitLab에서 마이그레이션

GitHub Actions Importer를 사용하여 GitLab에서 마이그레이션하는 정보

아래 지침은 GitHub Actions Importer를 사용하여 GitLab 파이프라인을 GitHub Actions로 마이그레이션할 수 있도록 환경을 설정하는 방법을 안내합니다.

필수 조건

GitHub Actions 워크플로로 변환하려는 파이프라인 및 작업이 있는 GitLab 계정 또는 조직
계정 또는 조직에 대한 GitLab personal access token 을 만들기 위한 액세스 권한입니다.
Linux 기반 컨테이너를 실행하고 필요한 도구를 설치할 수 있는 환경입니다.
- Docker가 설치되어 실행 중입니다.
- GitHub CLI가 설치됩니다.
참고

GitHub Actions Importer 컨테이너와 CLI는 CI 플랫폼과 동일한 서버에 설치할 필요가 없습니다.

제한 사항

GitLab 파이프라인에서 GitHub Actions로 프로세스를 GitHub Actions Importer와 함께 자동으로 마이그레이션하는 데에는 몇 가지 제한 사항이 있습니다.

서로 다른 워크플로우의 작업 간 자동 캐싱은 지원되지 않습니다.
audit 명령은 조직 계정을 사용할 때만 지원됩니다. 그러나 dry-run 및 migrate 명령은 조직 또는 사용자 계정과 함께 사용할 수 있습니다.

수동 작업

특정 GitLab 구성은 수동으로 마이그레이션해야 합니다. 여기에는 다음이 포함됩니다.

프로젝트 또는 그룹 변수 값 마스킹
아티팩트 보고서

수동 마이그레이션에 대한 자세한 내용은 GitLab CI/CD를 GitHub Actions으로 마이그레이션을(를) 참조하세요.

GitHub Actions Importer CLI 확장 설치

GitHub Actions Importer CLI 확장을 설치합니다.

Bash

gh extension install github/gh-actions-importer

gh extension install github/gh-actions-importer

다음 확장이 설치되어 있는지 확인:

$ gh actions-importer -h
Options:
  -?, -h, --help  Show help and usage information

Commands:
  update     Update to the latest version of GitHub Actions Importer.
  version    Display the version of GitHub Actions Importer.
  configure  Start an interactive prompt to configure credentials used to authenticate with your CI server(s).
  audit      Plan your CI/CD migration by analyzing your current CI/CD footprint.
  forecast   Forecast GitHub Actions usage from historical pipeline utilization.
  dry-run    Convert a pipeline to a GitHub Actions workflow and output its yaml file.
  migrate    Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes.

자격 증명 구성하기

configure CLI 명령은 GitLab 및 GitHub Actions Importer로 작업할 때 GitHub에 필요한 자격 증명과 옵션을 설정하는 데 사용됩니다.

를 만듭니다 GitHubpersonal access token (classic). 자세한 내용은 개인용 액세스 토큰 관리을(를) 참조하세요.

이 토큰에는 workflow 범위가 있어야 합니다.

토큰을 만든 후 복사하고 나중에 사용할 수 있도록 안전한 위치에 저장합니다.
GitLab personal access token을 만듭니다. 자세한 내용은 GitLab 설명서를 참조 Personal access tokens 하세요.

이 토큰에는 read_api 범위가 있어야 합니다.

토큰을 만든 후 복사하고 나중에 사용할 수 있도록 안전한 위치에 저장합니다.
터미널에서 CLI 명령을 실행 GitHub Actions Importerconfigure 합니다.
```
gh actions-importer configure
```

configure 명령을 실행하면 다음 정보를 입력하라는 메시지가 표시됩니다:

"어떤 CI 공급자를 구성하나요?"의 경우 화살표 키를 사용하여 GitLab 선택하고 Space 키를 눌러 선택한 다음 Enter 키를 누릅니다.
"Personal access token for GitHub"의 personal access token (classic) 경우 이전에 만든 값을 입력하고 Enter 키를 누릅니다.
"GitHub 인스턴스의 기본 URL"Enter 키를 눌러 기본값(https://github.com)을 적용합니다.
"GitLab에 대한 프라이빗 토큰"의 경우 이전에 만든 GitLab personal access token 의 값을 입력하고 Enter 키를 누릅니다.
"GitLab 인스턴스의 기본 URL"에 GitLab 인스턴스의 URL을 입력하고 Enter 키를 누릅니다.

configure 명령의 출력 예는 아래와 같습니다.

$ gh actions-importer configure
✔ Which CI providers are you configuring?: GitLab
Enter the following values (leave empty to omit):
✔ Personal access token for GitHub: ***************
✔ Base url of the GitHub instance: https://github.com
✔ Private token for GitLab: ***************
✔ Base url of the GitLab instance: http://localhost
Environment variables successfully updated.

터미널에서 GitHub Actions Importerupdate CLI 명령을 실행하여 GitHub PackagesContainer registry에 연결하고, 컨테이너 이미지가 최신 버전으로 업데이트되었는지 확인합니다.
```
gh actions-importer update
```
명령의 출력은 아래와 비슷해야 합니다:
```
Updating ghcr.io/actions-importer/cli:latest...
ghcr.io/actions-importer/cli:latest up-to-date
```

GitLab 감사 수행

audit 명령을 사용하여 GitLab 서버의 모든 파이프라인을 개략적으로 볼 수 있습니다.

audit 명령은 다음 단계를 수행합니다:

GitLab 서버에 정의된 모든 프로젝트를 가져옵니다.
각 파이프라인을 해당 GitHub Actions 워크플로로 변환합니다.
마이그레이션의 완전성과 복잡성을 GitHub Actions Importer와 함께 어느 정도까지 구현할 수 있는지를 요약한 보고서를 생성합니다.

감사 명령에 대한 필수 구성 요소

audit 명령을 사용하려면 GitLab 조직 계정으로 구성된 personal access token이 있어야 합니다.

감사 명령 실행

GitLab 서버에 대한 감사를 수행하려면 터미널에서 다음 명령을 실행하여 감사하는 네임스페이스 또는 그룹으로 my-gitlab-namespace을 바꿉니다.

gh actions-importer audit gitlab --output-dir tmp/audit --namespace my-gitlab-namespace

감사 결과 검사하기

지정된 출력 디렉터리의 파일에는 감사의 결과가 포함됩니다. 감사 결과에 대한 요약은 audit_summary.md 파일을 참조하세요.

감사 요약에는 다음의 섹션이 있습니다.

파이프라인

"파이프라인" 섹션에는 GitHub Actions Importer에 의해 수행된 전환율에 대한 개략적인 통계가 포함되어 있습니다.

아래에 "파이프라인" 섹션에 나타날 수 있는 몇 가지 주요 용어가 나와 있습니다.

성공한 파이프라인에서는 파이프라인 구성 요소와 개별 항목이 100% 자동으로 해당 GitHub Actions 항목으로 변환되었습니다.
부분적으로 성공한 파이프라인에는 모든 파이프라인 구문이 변환되었지만, 해당 항목으로 자동으로 GitHub Actions 변환되지 않은 일부 개별 항목이 있었습니다.
지원되지 않는 파이프라인은 .에서 지원하지 GitHub Actions Importer않는 정의 형식입니다.
실패한 파이프라인이 변환되는 동안 치명적인 오류가 발생했습니다. 이 현상은 다음의 3가지 이유로 발생할 수 있습니다.
- 파이프라인이 원래 잘못 구성되어 유효하지 않습니다.
- GitHub Actions Importer 변환할 때 내부 오류가 발생했습니다.
- 파이프라인에 액세스할 수 없게 되는 실패한 네트워크 응답이 있으며, 이는 종종 잘못된 자격 증명 때문입니다.

빌드 단계

"빌드 단계" 섹션에는 모든 파이프라인에서 사용되는 개별 빌드 단계에 대한 개요와 GitHub Actions Importer에 의해 자동으로 변환된 단계 수가 포함되어 있습니다.

아래에는 "빌드 단계" 섹션에 나타날 수 있는 몇 가지 주요 용어가 나열되어 있습니다.

알려진 빌드 단계는 해당 동작으로 자동으로 변환된 단계입니다.
알 수 없는 빌드 단계는 동등한 작업으로 자동 변환되지 않은 단계입니다.
지원되지 않는 빌드 단계는 다음과 같은 단계입니다.
- 기본적으로 GitHub Actions에서 지원되지 않습니다.
- GitHub Actions와 호환되지 않는 방식으로 구성됩니다.
작업은 변환된 워크플로에서 사용된 작업의 목록입니다. 이 작업은 다음과 같은 경우에 중요할 수 있습니다.
- GitHub Enterprise Server를 사용하는 경우 인스턴스에 동기화할 작업 목록을 수집 중입니다.
- 사용되는 작업의 조직 수준 허용 목록을 정의합니다. 이 작업 목록은 보안 또는 규정 준수 팀에서 검토해야 할 수도 있는 포괄적인 작업 목록입니다.

수동 작업

"수동 작업" 섹션에는 자동으로 완료할 수 없으며 수동으로 완료해야 하는 작업에 GitHub Actions Importer 대한 개요가 포함되어 있습니다.

다음은 "수동 작업" 섹션에 표시될 수 있는 몇 가지 주요 용어입니다.

비밀은 변환된 파이프라인에서 사용되는 리포지토리 또는 조직 수준의 비밀입니다. 이러한 파이프라인이 제대로 작동하려면 이러한 비밀을 수동으로 GitHub Actions 만들어야 합니다. 자세한 내용은 GitHub Actions에서 비밀 사용을(를) 참조하세요.
자체 호스팅 러너란 GitHub 호스팅 러너가 아닌, 변환된 파이프라인에서 참조되는 러너의 레이블을 의미합니다. 이 파이프라인들이 정상적으로 작동하려면 이러한 러너를 수동으로 정의해야 합니다.

파일

감사 보고서의 마지막 섹션에는 감사 중 디스크에 기록된 모든 파일의 매니페스트를 제공합니다.

각 파이프라인 파일에는 감사에 포함되는 다음과 같은 다양한 파일이 포함됩니다:

GitHub에서 정의된 원래 파이프라인입니다.
파이프라인을 변환하기 위해 사용되는 모든 네트워크 응답입니다.
변환된 워크플로 파일입니다.
실패한 파이프라인 변환 문제를 해결하기 위해 사용할 수 있는 스택 추적입니다.

또한 workflow_usage.csv 파일에는 성공적으로 변환된 각 파이프라인에서 사용되는 모든 작업, 비밀 및 실행기의 쉼표로 구분된 목록이 포함됩니다. 이는 작업, 비밀 또는 실행기를 사용하는 워크플로를 결정하는 데 유용할 수 있으며, 보안 검토를 수행하는 데 유용할 수 있습니다.

잠재적 빌드 러너 사용량 예측

이 명령을 사용하여 forecast GitLab 서버에서 완료된 파이프라인 실행의 메트릭을 계산하여 잠재적 사용 GitHub Actions 량을 예측할 수 있습니다.

예측 명령 실행하기

잠재적 GitHub Actions 사용량 예측을 수행하려면 터미널에서 다음 명령을 실행하여 예측하려는 네임스페이스 또는 그룹으로 바꿉 my-gitlab-namespace 니다. 기본적으로 GitHub Actions Importer 예측 보고서에 이전 7일이 포함됩니다.

gh actions-importer forecast gitlab --output-dir tmp/forecast --namespace my-gitlab-namespace

전체 네임스페이스 예측

전체 네임스페이스와 모든 하위 그룹을 예측하려면 인수 또는 --namespace 환경 변수에서 NAMESPACE 각 하위 그룹을 지정해야 합니다.

예시:

gh actions-importer forecast gitlab --namespace my-gitlab-namespace my-gitlab-namespace/subgroup-one my-gitlab-namespace/subgroup-two ...

예측 보고서 검사하기

지정된 출력 디렉터리의 forecast_report.md 파일에 예측 결과가 포함되어 있습니다.

다음은 예상 보고서에 표시될 수 있는 몇 가지 주요 용어입니다:

작업 수는 완료된 작업의 총 개수입니다.
파이프라인 수는 사용된 고유 파이프라인의 수입니다.
실행 시간: 은 러너가 작업에 소비한 시간을 나타냅니다. 이 메트릭은 GitHub에서 호스팅되는 실행기의 비용을 계획하는 데 사용할 수 있습니다.
- 이 메트릭은 지출할 것으로 예상되는 금액과 상관 관계가 있습니다 GitHub Actions. 해당 금액은 작업 시간(분) 동안 사용되는 하드웨어에 따라 달라집니다. 가격 계산기를GitHub Actions 사용하여 비용을 예측할 수 있습니다.
큐 시간: 메트릭은 작업이 실행할 수 있는 러너를 기다리는 데 소요되는 시간을 나타냅니다.
동시 작업 메트릭은 특정 시간에 실행 중인 작업의 양을 설명합니다. 이 메트릭은 구성해야 하는 러너 수를 정의하는 데 사용할 수 있습니다.

또한 이러한 메트릭은 GitLab의 각 러너 대기열에 대해 정의됩니다. 이 기능은 호스트형 또는 자체 호스팅형 런너 또는 고사양 또는 저사양 컴퓨터가 혼합되어 있는 경우 특히 유용하므로 다양한 유형의 런너에 특정한 메트릭을 확인할 수 있습니다.

GitLab 파이프라인에서 마이그레이션 테스트를 실행합니다.

이 dry-run 명령을 사용하여 GitLab 파이프라인을 해당 GitHub Actions 워크플로로 변환할 수 있습니다.

시험 실행 명령 실행

이 dry-run 명령을 사용하여 GitLab 파이프라인을 동등한 GitHub Actions 워크플로로 변환할 수 있습니다. 드라이런은 지정된 디렉터리에 출력 파일을 만들지만 파이프라인 마이그레이션을 위한 풀 리퀘스트를 열지 않습니다.

GitHub Actions로 GitLab 파이프라인을 마이그레이션하는 드라이 런을 수행하려면 터미널에서 다음 명령을 실행하세요. 이때 my-gitlab-project은 GitLab 프로젝트 슬러그로, my-gitlab-namespace는 드라이 런을 수행할 네임스페이스 또는 그룹(하위 그룹의 경우 전체 그룹 경로(예: my-org/my-team))으로 바꿔 넣습니다.

gh actions-importer dry-run gitlab --output-dir tmp/dry-run --namespace my-gitlab-namespace --project my-gitlab-project

변환된 워크플로 점검

지정된 출력 디렉터리에서 드라이런 로그 및 변환된 워크플로 파일을 볼 수 있습니다.

GitHub Actions Importer이(가) 알 수 없는 빌드 단계 또는 부분적으로 성공한 파이프라인과 같이 자동으로 변환할 수 없는 항목이 있는 경우 변환 프로세스를 추가로 사용자 지정하는 사용자 지정 변환기를 만들 수 있습니다. 자세한 내용은 사용자 지정 변환기를 사용하여 GitHub Actions Importer 확장을(를) 참조하세요.

GitLab 파이프라인의 프로덕션 마이그레이션 수행

이 migrate 명령을 사용하여 GitLab 파이프라인을 변환하고 해당하는 GitHub Actions 워크플로를 사용하여 끌어오기 요청을 열 수 있습니다.

마이그레이션 명령 실행

GitLab 파이프라인 GitHub Actions을 마이그레이션하려면 터미널에서 다음 명령을 실행하여 다음 값을 대체합니다.

GitHub 리포지토리의 URL이 포함된 target-url 값
my-gitlab-project GitLab 프로젝트 슬러그와 함께
마이그레이션할 네임스페이스 또는 그룹이 포함된 my-gitlab-namespace(하위 그룹의 경우 전체 경로, 예: my-org/my-team)

gh actions-importer migrate gitlab --target-url https://github.com/:owner/:repo --output-dir tmp/migrate --namespace my-gitlab-namespace --project my-gitlab-project

명령의 출력에는 변환된 워크플로를 리포지토리에 추가하는 끌어오기 요청에 대한 URL이 포함됩니다. 성공적인 출력의 예는 다음과 유사합니다:

$ gh actions-importer migrate gitlab --target-url https://github.com/octo-org/octo-repo --output-dir tmp/migrate --namespace octo-org --project monas-project
[2022-08-20 22:08:20] Logs: 'tmp/migrate/log/actions-importer-20220916-014033.log'
[2022-08-20 22:08:20] Pull request: 'https://github.com/octo-org/octo-repo/pull/1'

끌어오기 요청 검사하기

migrate 명령의 성공적인 실행의 출력에는 변환된 워크플로를 리포지토리에 추가하는 새 끌어오기 요청에 대한 링크가 포함되어 있습니다.

끌어오기 요청의 몇 가지 중요 요소는 다음과 같습니다.

끌어오기 요청 설명에서 수동으로 완료해야 하는 단계를 나열하는 섹션은 파이프라인을 GitHub Actions로 마이그레이션을 완료할 수 있습니다. 예를 들어, 이 섹션에서는 워크플로에 사용되는 비밀을 만들도록 지시할 수 있습니다.
변환된 워크플로 파일입니다. 끌어오기 요청에서 Files changed 탭을 선택하여 GitHub 리포지토리에 추가될 워크플로 파일을 봅니다.

끌어오기 요청 검사를 마치면 병합하여 워크플로를 GitHub 리포지토리에 추가할 수 있습니다.

참조

이 섹션에는 GitLab에서 마이그레이션하는 데 사용할 GitHub Actions Importer 때 환경 변수, 선택적 인수 및 지원되는 구문에 대한 참조 정보가 포함되어 있습니다.

환경 변수 사용

GitHub Actions Importer은(는) 인증 구성에 환경 변수를 사용합니다. 이러한 변수는 configure 명령을 사용하여 구성 프로세스를 따르면 설정됩니다. 자세한 정보는 자격 증명 구성 섹션을 참조하세요.

GitHub Actions Importer 에서는 다음 환경 변수를 사용하여 GitLab 인스턴스에 연결합니다.

GITHUB_ACCESS_TOKEN: 변환된 워크플로를 사용하여 끌어오기 요청을 만드는 데 사용되는 personal access token (classic)(workflow 범위 필요)
GITHUB_INSTANCE_URL: 대상 GitHub 인스턴스에 대한 URL(예: https://github.com)입니다.
GITLAB_ACCESS_TOKEN: GitLab 리소스를 확인하는 데 사용되는 GitLab personal access token입니다.
GITLAB_INSTANCE_URL: GitLab 인스턴스의 URL입니다.
NAMESPACE: GitLab 파이프라인을 포함하는 네임스페이스 또는 그룹입니다.

이러한 환경 변수는 실행될 때 .env.local 로드되는 GitHub Actions Importer 파일에 지정할 수 있습니다.

선택적 인수 사용

GitHub Actions Importer 하위 명령과 함께 사용하여 마이그레이션을 사용자 지정할 수 있는 선택적 인수가 있습니다.

`--source-file-path`

--source-file-path 인수를 forecast, dry-run 또는 migrate 하위 명령과 함께 사용할 수 있습니다.

기본적으로 GitHub Actions Importer 소스 제어에서 파이프라인 콘텐츠를 가져옵니다. 인수는 --source-file-path 지정된 소스 파일 경로를 대신 사용하도록 지시 GitHub Actions Importer 합니다.

예시:

gh actions-importer dry-run gitlab --output-dir output/ --namespace my-gitlab-namespace --project my-gitlab-project --source-file-path path/to/.gitlab-ci.yml

하위 명령을 실행할 forecast 때 여러 원본 파일을 제공하려는 경우 파일 경로 값에서 패턴 일치를 사용할 수 있습니다. 다음 예제에서는 GitHub Actions Importer에 ./tmp/previous_forecast/jobs/*.json 파일 경로와 일치하는 모든 원본 파일을 제공합니다.

gh actions-importer forecast gitlab --output-dir output/ --namespace my-gitlab-namespace --project my-gitlab-project --source-file-path ./tmp/previous_forecast/jobs/*.json

`--config-file-path`

--config-file-path 인수를 audit, dry-run 및 migrate 하위 명령과 함께 사용할 수 있습니다.

기본적으로 GitHub Actions Importer 소스 제어에서 파이프라인 콘텐츠를 가져옵니다. 인수는 --config-file-path 지정된 소스 파일을 대신 사용하도록 지시 GitHub Actions Importer 합니다.

이 인수를 --config-file-path 사용하여 변환된 재사용 가능한 워크플로를 마이그레이션할 리포지토리를 지정할 수도 있습니다.

감사의 예

이 예제에서는 GitHub Actions Importer 지정된 YAML 구성 파일을 사용하여 감사를 수행합니다.

gh actions-importer audit gitlab --output-dir path/to/output/ --namespace my-gitlab-namespace --config-file-path path/to/gitlab/config.yml

구성 파일을 사용하여 GitLab 인스턴스를 감사하려면 파일이 다음 형식이어야 하며 각 repository_slug 값은 고유해야 합니다.

source_files:
  - repository_slug: namespace/project-name
    path: path/to/.gitlab-ci.yml
  - repository_slug: namespace/some-other-project-name
    path: path/to/.gitlab-ci.yml

드라이 실행 예

이 예제 GitHub Actions Importer 에서는 지정된 YAML 구성 파일을 원본 파일로 사용하여 마른 실행을 수행합니다.

파이프라인은 구성 파일의 repository_slug 값을 --namespace 및 --project 옵션 값과 일치시켜 선택합니다. 그런 다음 path은 지정된 소스 파일을 가져오는 데 사용됩니다.

gh actions-importer dry-run gitlab --namespace my-gitlab-namespace --project my-gitlab-project-name --output-dir ./output/ --config-file-path ./path/to/gitlab/config.yml

변환된 재사용 가능한 워크플로의 리포지토리 지정

GitHub Actions Importer 는 인수에 --config-file-path 제공된 YAML 파일을 사용하여 변환된 재사용 가능한 워크플로가 마이그레이션되는 리포지토리를 확인합니다.

시작하려면 인수 없이 감사를 실행해야 합니다.--config-file-path

gh actions-importer audit gitlab --output-dir ./output/

이 명령의 출력에는 에 의해 config.yml변환된 모든 복합 작업의 목록이 포함된 이름이 지정된 GitHub Actions Importer 파일이 포함됩니다. 예를 들어 config.yml 파일에는 다음과 같은 내용이 있을 수 있습니다.

reusable_workflows:
  - name: my-reusable-workflow.yml
    target_url: https://github.com/octo-org/octo-repo
    ref: main

이 파일을 사용하여 재사용 가능한 워크플로 또는 복합 작업을 추가할 리포지토리 및 참조를 지정할 수 있습니다. 그런 다음 --config-file-path 인수를 사용하여 config.yml 파일을 GitHub Actions Importer에 제공할 수 있습니다. 예를 들어 명령을 실행할 migrate 때 이 파일을 사용하여 구성 파일에 정의된 각 고유 리포지토리에 대한 끌어오기 요청을 열 수 있습니다.

gh actions-importer migrate gitlab --project my-project-name --output-dir output/ --config-file-path config.yml --target-url https://github.com/my-org/my-repo

GitLab 파이프라인에 지원되는 구문

다음 표에서는 현재 변환할 수 있는 속성 GitHub Actions Importer 의 형식을 보여줍니다. GitLab 파이프라인 구문이 GitHub Actions와 어떻게 부합하는지에 대한 자세한 내용은 GitLab CI/CD를 GitHub Actions으로 마이그레이션을 참조하세요.

GitLab 파이프라인	GitHub Actions	상태
`after_script`	`jobs.<job_id>.steps`	지원됨
`auto_cancel_pending_pipelines`	`concurrency`	지원됨
`before_script`	`jobs.<job_id>.steps`	지원됨
`build_timeout` 또는 `timeout`	`jobs.<job_id>.timeout-minutes`	지원됨
`default`	해당 없음	지원됨
`image`	`jobs.<job_id>.container`	지원됨
`job`	`jobs.<job_id>`	지원됨
`needs`	`jobs.<job_id>.needs`	지원됨
`only_allow_merge_if_pipeline_succeeds`	`on.pull_request`	지원됨
`resource_group`	`jobs.<job_id>.concurrency`	지원됨
`schedule`	`on.schedule`	지원됨
`script`	`jobs.<job_id>.steps`	지원됨
`stages`	`jobs`	지원됨
`tags`	`jobs.<job_id>.runs-on`	지원됨
`variables`
`env`, `jobs.<job_id>.env`	지원됨
새 커밋에 대한 파이프라인 실행	`on.push`	지원됨
수동으로 파이프라인 실행	`on.workflow_dispatch`	지원됨
`environment`	`jobs.<job_id>.environment`	부분적으로 지원됨
`include`	명령문 `include`에서 참조된 파일은 변환되기 전에 단일 작업 그래프로 병합됩니다.	부분적으로 지원됨
`only` 또는 `except`	`jobs.<job_id>.if`	부분적으로 지원됨
`parallel`	`jobs.<job_id>.strategy`	부분적으로 지원됨
`rules`	`jobs.<job_id>.if`	부분적으로 지원됨
`services`	`jobs.<job_id>.services`	부분적으로 지원됨
`workflow`	`if`	부분적으로 지원됨

지원되는 GitLab 구문에 대한 자세한 내용은 리포지토리를 github/gh-actions-importer 참조하세요.

환경 변수 구문

GitHub Actions Importer에서는 아래 표의 매핑을 사용하여 기본 GitLab 환경 변수를 GitHub Actions의 가장 가까운 해당 항목으로 변환합니다.

GitLab	GitHub Actions
`CI_API_V4_URL`	`${{ github.api_url }}`
`CI_BUILDS_DIR`	`${{ github.workspace }}`
`CI_COMMIT_BRANCH`	`${{ github.ref }}`
`CI_COMMIT_REF_NAME`	`${{ github.ref }}`
`CI_COMMIT_REF_SLUG`	`${{ github.ref }}`
`CI_COMMIT_SHA`	`${{ github.sha }}`
`CI_COMMIT_SHORT_SHA`	`${{ github.sha }}`
`CI_COMMIT_TAG`	`${{ github.ref }}`
`CI_JOB_ID`	`${{ github.job }}`
`CI_JOB_MANUAL`	`${{ github.event_name == 'workflow_dispatch' }}`
`CI_JOB_NAME`	`${{ github.job }}`
`CI_JOB_STATUS`	`${{ job.status }}`
`CI_JOB_URL`	`${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}`
`CI_JOB_TOKEN`	`${{ github.token }}`
`CI_NODE_INDEX`	`${{ strategy.job-index }}`
`CI_NODE_TOTAL`	`${{ strategy.job-total }}`
`CI_PIPELINE_ID`	`${{ github.repository}}/${{ github.workflow }}`
`CI_PIPELINE_IID`	`${{ github.workflow }}`
`CI_PIPELINE_SOURCE`	`${{ github.event_name }}`
`CI_PIPELINE_TRIGGERED`	`${{ github.actions }}`
`CI_PIPELINE_URL`	`${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}`
`CI_PROJECT_DIR`	`${{ github.workspace }}`
`CI_PROJECT_ID`	`${{ github.repository }}`
`CI_PROJECT_NAME`	`${{ github.event.repository.name }}`
`CI_PROJECT_NAMESPACE`	`${{ github.repository_owner }}`
`CI_PROJECT_PATH_SLUG`	`${{ github.repository }}`
`CI_PROJECT_PATH`	`${{ github.repository }}`
`CI_PROJECT_ROOT_NAMESPACE`	`${{ github.repository_owner }}`
`CI_PROJECT_TITLE`	`${{ github.event.repository.full_name }}`
`CI_PROJECT_URL`	`${{ github.server_url }}/${{ github.repository }}`
`CI_REPOSITORY_URL`	`${{ github.event.repository.clone_url }}`
`CI_RUNNER_EXECUTABLE_ARCH`	`${{ runner.os }}`
`CI_SERVER_HOST`	`${{ github.server_url }}`
`CI_SERVER_URL`	`${{ github.server_url }}`
`CI_SERVER`	`${{ github.actions }}`
`GITLAB_CI`	`${{ github.actions }}`
`GITLAB_USER_EMAIL`	`${{ github.actor }}`
`GITLAB_USER_ID`	`${{ github.actor }}`
`GITLAB_USER_LOGIN`	`${{ github.actor }}`
`GITLAB_USER_NAME`	`${{ github.actor }}`
`TRIGGER_PAYLOAD`	`${{ github.event_path }}`
`CI_MERGE_REQUEST_ASSIGNEES`	`${{ github.event.pull_request.assignees }}`
`CI_MERGE_REQUEST_ID`	`${{ github.event.pull_request.number }}`
`CI_MERGE_REQUEST_IID`	`${{ github.event.pull_request.number }}`
`CI_MERGE_REQUEST_LABELS`	`${{ github.event.pull_request.labels }}`
`CI_MERGE_REQUEST_MILESTONE`	`${{ github.event.pull_request.milestone }}`
`CI_MERGE_REQUEST_PROJECT_ID`	`${{ github.repository }}`
`CI_MERGE_REQUEST_PROJECT_PATH`	`${{ github.repository }}`
`CI_MERGE_REQUEST_PROJECT_URL`	`${{ github.server_url }}/${{ github.repository }}`
`CI_MERGE_REQUEST_REF_PATH`	`${{ github.ref }}`
`CI_MERGE_REQUEST_SOURCE_BRANCH_NAME`	`${{ github.event.pull_request.head.ref }}`
`CI_MERGE_REQUEST_SOURCE_BRANCH_SHA`	`${{ github.event.pull_request.head.sha}}`
`CI_MERGE_REQUEST_SOURCE_PROJECT_ID`	`${{ github.event.pull_request.head.repo.full_name }}`
`CI_MERGE_REQUEST_SOURCE_PROJECT_PATH`	`${{ github.event.pull_request.head.repo.full_name }}`
`CI_MERGE_REQUEST_SOURCE_PROJECT_URL`	`${{ github.event.pull_request.head.repo.url }}`
`CI_MERGE_REQUEST_TARGET_BRANCH_NAME`	`${{ github.event.pull_request.base.ref }}`
`CI_MERGE_REQUEST_TARGET_BRANCH_SHA`	`${{ github.event.pull_request.base.sha }}`
`CI_MERGE_REQUEST_TITLE`	`${{ github.event.pull_request.title }}`
`CI_EXTERNAL_PULL_REQUEST_IID`	`${{ github.event.pull_request.number }}`
`CI_EXTERNAL_PULL_REQUEST_SOURCE_REPOSITORY`	`${{ github.event.pull_request.head.repo.full_name }}`
`CI_EXTERNAL_PULL_REQUEST_TARGET_REPOSITORY`	`${{ github.event.pull_request.base.repo.full_name }}`
`CI_EXTERNAL_PULL_REQUEST_SOURCE_BRANCH_NAME`	`${{ github.event.pull_request.head.ref }}`
`CI_EXTERNAL_PULL_REQUEST_SOURCE_BRANCH_SHA`	`${{ github.event.pull_request.head.sha }}`
`CI_EXTERNAL_PULL_REQUEST_TARGET_BRANCH_NAME`	`${{ github.event.pull_request.base.ref }}`
`CI_EXTERNAL_PULL_REQUEST_TARGET_BRANCH_SHA`	`${{ github.event.pull_request.base.sha }}`

법적 고지

부분은 MIT 라이선스에 따라 https://github.com/github/gh-actions-importer/에서 조정되었습니다.

MIT License

Copyright (c) 2022 GitHub

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

GitHub Actions Importer를 사용하여 GitLab에서 마이그레이션

이 기사에서