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

GitHub Actions Importer을(를) 사용하여 Bamboo 파이프라인을 GitHub Actions(으)로 마이그레이션하는 작업을 자동화하는 방법을 알아봅니다.

이 문서의 내용

법적 고지

GitHub Actions 가져오기를 사용하여 Bamboo에서 마이그레이션 정보

아래 지침은 GitHub Actions Importer을(를) 사용하여 Bamboo 파이프라인을 GitHub Actions(으)로 마이그레이션하도록 환경을 구성하는 방법을 안내합니다.

필수 조건

  • GitHub Actions 워크플로로 변환할 프로젝트 및 파이프라인과 작업이 있는 Bamboo 계정 또는 조직

  • 7.1.1 이상의 Bamboo 버전.

  • 계정 또는 조직의 Bamboo personal access token을(를) 만들 수 있는 액세스 권한

  • Linux 기반 컨테이너를 실행하고 필요한 도구를 설치할 수 있는 환경입니다.

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

제한 사항

GitHub Actions Importer을(를) 사용하여 Bamboo에서 GitHub Actions(으)로 마이그레이션하는 경우 몇 가지 제한 사항이 있습니다.

  • GitHub Actions Importer은(는) Bamboo Server에서 생성한 YAML 사양을 사용하여 마이그레이션을 진행합니다. Bamboo에서 YAML로의 내보내기를 지원하지 않는 경우 누락된 정보는 마이그레이션되지 않습니다.
  • 트리거 조건은 지원되지 않습니다. GitHub Actions Importer이(가) 조건이 있는 트리거를 발견하면 조건이 주석으로 표시되고 트리거는 조건이 없는 상태로 변환됩니다.
  • 아티팩트 저장에 대한 사용자 지정 설정이 있는 Bamboo Plan은 변환되지 않습니다. 대신 아티팩트가 upload-artifact 및 download-artifact 동작을 사용하여 저장되고 검색됩니다.
  • 비활성화된 계획은 GitHub UI에서 수동으로 비활성화해야 합니다. 자세한 내용은 "워크플로를 사용/사용하지 않도록 설정"을(를) 참조하세요.
  • 비활성화된 작업은 실행되지 않는 if: false 조건으로 변환됩니다. 작업을 활성화하려면 이 항목을 제거해야 합니다.
  • 비활성화된 작업은 Bamboo API를 사용할 때 내보낸 계획에 포함되지 않으므로 변환되지 않습니다.
  • Bamboo는 빌드가 완료된 후 빌드 작업 영역을 정리하는 옵션이 있습니다. GitHub 호스팅 실행기 또는 임시 자체 호스팅 실행기는 이 작업을 자동으로 처리할 것으로 가정하기 때문에 작업은 변환되지 않습니다.
  • GitHub Actions에 해당하는 항목이 없으므로 중단된 빌드 검색 옵션이 변환되지 않습니다. 가장 가까운 옵션은 timeout-minutes 작업에 있으며, 작업을 실행할 최대 시간(분)을 설정하는 데 사용할 수 있습니다. 자세한 내용은 "GitHub Actions에 대한 워크플로 구문"을(를) 참조하세요.
  • GitHub Actions에 해당하는 항목이 없으므로 패턴 일치 레이블 지정이 변환되지 않습니다.
  • 모든 아티팩트가 shared인지 아닌지 여부와 관계없이 actions/upload-artifact(으)로 변환되므로 모든 아티팩트는 워크플로의 어떤 작업에서도 다운로드할 수 있습니다.
  • 권한은 GitHub Actions에 해당하는 항목이 없으므로 변환되지 않습니다.
  • Bamboo 버전이 7.1.1에서 8.1.1 사이인 경우 프로젝트 및 계획 변수는 마이그레이션되지 않습니다.

수동 작업

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

  • 마스킹된 변수
  • 아티팩트 유효기간 설정

GitHub Actions Importer CLI 확장 프로그램 설치하기

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

    Bash
    gh extension install github/gh-actions-importer

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

    $ 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 명령은 Bamboo 및 GitHub(으)로 작업할 때 GitHub Actions Importer에 필요한 자격 증명 및 옵션을 설정하는 데 사용됩니다.

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

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

    토큰을 만든 후 복사하고 나중에 사용할 수 있도록 안전한 위치에 저장합니다.

  2. Bamboo personal access token을(를) 만듭니다. 자세한 내용은 Bamboo 설명서의 Personal Access Tokens을(를) 참조하세요.

    변환할 리소스에 따라 토큰에 다음 권한이 있어야 합니다.

    리소스 종류보기구성 보기편집
    계획 수립
    배포 프로젝트
    배포 환경

    토큰을 만든 후 복사하고 나중에 사용할 수 있도록 안전한 위치에 저장합니다.

  3. 터미널에서 GitHub Actions Importer configure CLI 명령을 실행합니다.

    gh actions-importer configure

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

    • "어떤 CI 공급자를 구성하고 있나요?"에 대해 화살표 키를 사용하여 Bamboo을(를) 선택하고Space을 눌러 선택한 다음Enter를 누릅니다.
    • "Personal access token for GitHub"에 앞서 만든 personal access token (classic)의 값을 입력하고 EnterEnter다.
    • "GitHub 인스턴스의 기본 URL"의 경우 GitHub Enterprise Server 인스턴스의 URL을 입력하고 Enter를 누릅니다.
    • "Bamboo용 Personal access token"의 경우 이전에 만든 Bamboo personal access token의 값을 입력하고 Enter 키를 누릅니다.
    • "Bamboo 인스턴스의 기준 URL"의 경우 Bamboo Server 또는 Bamboo Data Center 인스턴스의 URL을 입력하고 Enter 키를 누릅니다.

    configure 명령의 예가 아래에 나와 있습니다:

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

  4. 터미널에서 GitHub Actions Importer를 실행합니다.update CLI 명령을 실행하여 GitHub Packages에 연결합니다. {data variables.product.prodname_container_registry %}에 연결하고 컨테이너 이미지가 최신 버전으로 업데이트되었는지 확인합니다.

    gh actions-importer update

    명령의 출력은 아래와 비슷해야 합니다:

    Updating ghcr.io/actions-importer/cli:latest...
ghcr.io/actions-importer/cli:latest up-to-date

Bamboo 감사 수행

audit 명령으로 Bamboo 조직의 모든 프로젝트를 개략적으로 볼 수 있습니다.

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

  1. Bamboo 조직에 정의된 모든 프로젝트를 가져옵니다.
  2. 각 파이프라인을 해당하는 GitHub Actions 워크플로로 변환합니다.
  3. GitHub Actions Importer을(를) 사용하여 마이그레이션의 완전하고 복잡한 작업이 가능한 방법을 요약하는 보고서를 생성합니다.

감사 명령 실행

Bamboo 인스턴스를 감사하려면 터미널에서 다음 명령을 실행합니다.

gh actions-importer audit bamboo --output-dir tmp/audit

감사 결과 검사하기

지정된 출력 디렉터리의 파일에는 감사의 결과가 포함됩니다. 감사 결과에 대한 요약은 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호스티드 러너가 아닌 변환된 파이프라인에서 참조되는 실행기의 레이블을 나타냅니다. 이러한 파이프라인을 제대로 작동시키려면 이러한 실행기를 수동으로 정의해야 합니다.

Files

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

각 파이프라인 파일에는 다음을 포함하며, 감사에 포함된 다양한 파일이 있습니다.

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

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

예측 사용

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

예측 명령 실행하기

잠재적인 GitHub Actions 사용량을 예측하려면 터미널에서 다음 명령을 실행합니다. 기본적으로 GitHub Actions Importer은(는) 예측 보고서에 이전 7일을 포함합니다.

gh actions-importer forecast bamboo --output-dir tmp/forecast_reports

프로젝트 예측

예측을 프로젝트와 연결된 계획 및 배포 환경으로 제한하려면 값이 빌드 프로젝트 키로 설정된 --project 옵션을 사용할 수 있습니다.

예시:

gh actions-importer forecast bamboo --project PAN --output-dir tmp/forecast_reports

예측 보고서 검사하기

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

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

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

Bamboo 파이프라인의 마이그레이션 시험 실행

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

빌드 계획에 대한 마이그레이션 시험 실행

Bamboo 빌드 계획을 GitHub Actions(으)로 마이그레이션하는 시험을 실행하려면 터미널에서 다음 명령을 실행하여 :my_plan_slug을(를) <projectKey>-<planKey> 형식(예: PAN-SCRIP)의 계획 프로젝트 및 계획 키로 바꿉니다.

gh actions-importer dry-run bamboo build --plan-slug :my_plan_slug --output-dir tmp/dry-run

배포 프로젝트를 위한 마이그레이션 시험 실행

Bamboo 배포 프로젝트를 GitHub Actions(으)로 마이그레이션하는 시험을 실행하려면 터미널에서 다음 명령을 실행하여 :my_deployment_project_id을(를) 변환 중인 배포 프로젝트의 ID로 바꿉니다.

gh actions-importer dry-run bamboo deployment --deployment-project-id :my_deployment_project_id --output-dir tmp/dry-run

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

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

Bamboo 파이프라인의 생산 마이그레이션

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

빌드 계획에 대한 마이그레이션 명령 실행

Bamboo 빌드 계획을 GitHub Actions(으)로 마이그레이션하려면 터미널에서 다음 명령을 실행하여 target-url 값을 GitHub Enterprise Server 리포지토리의 URL로, :my_plan_slug을(를) <projectKey>-<planKey> 형식의 계획 프로젝트 및 계획 키로 바꿉니다.

gh actions-importer migrate bamboo build --plan-slug :my_plan_slug --target-url :target_url --output-dir tmp/migrate

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

$ gh actions-importer migrate bamboo build --plan-slug :PROJECTKEY-PLANKEY --target-url https://github.com/octo-org/octo-repo --output-dir tmp/migrate
[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'

배포 프로젝트에 대한 마이그레이션 명령 실행

Bamboo 배포 계획을 GitHub Actions(으)로 마이그레이션하려면 터미널에서 다음 명령을 실행하여 target-url 값을 GitHub Enterprise Server 리포지토리의 URL로, :my_deployment_project_id을(를) 변환하는 배포 프로젝트의 ID로 바꿉니다.

gh actions-importer migrate bamboo deployment --deployment-project-id :my_deployment_project_id --target-url :target_url --output-dir tmp/migrate

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

$ gh actions-importer migrate bamboo deployment --deployment-project-id 123 --target-url https://github.com/octo-org/octo-repo --output-dir tmp/migrate
[2023-04-20 22:08:20] Logs: 'tmp/migrate/log/actions-importer-20230420-014033.log'
[2023-04-20 22:08:20] Pull request: 'https://github.com/octo-org/octo-repo/pull/1'

끌어오기 요청 검사하기

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

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

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

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

참조

이 섹션에는 GitHub Actions Importer을(를) 사용하여 Bamboo에서 마이그레이션할 때의 환경 변수, 선택형 인수, 지원되는 구문에 대한 참조 정보가 포함되어 있습니다.

환경 변수 사용

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

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

  • GITHUB_ACCESS_TOKEN: 변환된 워크플로(repo 및 workflow 범위 필요)를 사용하여 끌어오기 요청을 만드는 데 사용되는 personal access token (classic)입니다.
  • GITHUB_INSTANCE_URL: 대상 GitHub 인스턴스의 URL입니다(예: https://github.com).
  • BAMBOO_ACCESS_TOKEN: Bamboo 인스턴스를 인증하는 데 사용되는 Bamboo personal access token입니다.
  • BAMBOO_INSTANCE_URL: Bamboo 인스턴스의 URL(예: https://bamboo.example.com)입니다.

이러한 환경 변수는 .env.local 파일에 지정할 수 있으며, 이 파일은 실행 시 GitHub Actions Importer에 의해 로드됩니다.

선택형 인수

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

--source-file-path

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

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

예시:

gh actions-importer dry-run bamboo build --plan-slug IN-COM -o tmp/bamboo --source-file-path ./path/to/my/bamboo/file.yml

--config-file-path

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

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

감사 예

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

gh actions-importer audit bamboo -o tmp/bamboo --config-file-path "./path/to/my/bamboo/config.yml"

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

source_files:
  - repository_slug: IN/COM
    path: path/to/one/source/file.yml
  - repository_slug: IN/JOB
    path: path/to/another/source/file.yml
드라이 실행 예

이 예제에서 GitHub Actions Importer는 지정된 YAML 구성 파일을 소스 파일로 사용하여 드라이런을 수행합니다.

리포지토리 슬러그는 --plan-slug 옵션을 사용하여 빌드됩니다. 원본 파일 경로는 지정된 원본 파일에서 일치 및 끌어오기됩니다.

gh actions-importer dry-run bamboo build --plan-slug IN-COM -o tmp/bamboo --config-file-path "./path/to/my/bamboo/config.yml"

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

다음 표에는 GitHub Actions Importer가 현재 변환할 수 있는 속성 유형이 나와 있습니다.

BambooGitHub 작업상태
environmentsjobs지원됨
environments.<environment_id>jobs.<job_id>지원됨
<job_id>.artifactsjobs.<job_id>.steps.actions/upload-artifact지원됨
<job_id>.artifact-subscriptionsjobs.<job_id>.steps.actions/download-artifact지원됨
<job_id>.dockerjobs.<job_id>.container지원됨
<job_id>.final-tasksjobs.<job_id>.steps.if지원됨
<job_id>.requirementsjobs.<job_id>.runs-on지원됨
<job_id>.tasksjobs.<job_id>.steps지원됨
<job_id>.variablesjobs.<job_id>.env지원됨
stagesjobs.<job_id>.needs지원됨
stages.<stage_id>.finaljobs.<job_id>.if지원됨
stages.<stage_id>.jobsjobs지원됨
stages.<stage_id>.jobs.<job_id>jobs.<job_id>지원됨
stages.<stage_id>.manualjobs.<job_id>.environment지원됨
triggerson지원됨
dependenciesjobs.<job_id>.steps.<gh cli step>부분적으로 지원됨
branches해당 없음지원되지 않음
deployment.deployment-permissions해당 없음지원되지 않음
environment-permissions해당 없음지원되지 않음
notifications해당 없음지원되지 않음
plan-permissions해당 없음지원되지 않음
release-naming해당 없음지원되지 않음
repositories해당 없음지원되지 않음

지원되는 Bamboo 개념 및 플러그인 매핑에 대한 자세한 내용은 github/gh-actions-importer 리포지토리를 참조하세요.

환경 변수 매핑

GitHub Actions Importer은(는) 아래 표의 매핑을 사용하여 기본 Bamboo 환경 변수를 GitHub Actions 내의 가장 가까운 값으로 변환합니다.

BambooGitHub 작업
bamboo.agentId${{ github.runner_name }}
bamboo.agentWorkingDirectory${{ github.workspace }}
bamboo.buildKey${{ github.workflow }}-${{ github.job }}
bamboo.buildNumber${{ github.run_id }}
bamboo.buildPlanName${{ github.repository }}-${{ github.workflow }}-${{ github.job }
bamboo.buildResultKey${{ github.workflow }}-${{ github.job }}-${{ github.run_id }}
bamboo.buildResultsUrl${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
bamboo.build.working.directory${{ github.workspace }}
bamboo.deploy.project${{ github.repository }}
bamboo.ManualBuildTriggerReason.userName${{ github.actor }}
bamboo.planKey${{ github.workflow }}
bamboo.planName${{ github.repository }}-${{ github.workflow }}
bamboo.planRepository.branchDisplayName${{ github.ref }}
bamboo.planRepository.<position>.branch${{ github.ref }}
bamboo.planRepository.<position>.branchName${{ github.ref }}
bamboo.planRepository.<position>.name${{ github.repository }}
bamboo.planRepository.<position>.repositoryUrl${{ github.server }}/${{ github.repository }}
bamboo.planRepository.<position>.revision${{ github.sha }}
bamboo.planRepository.<position>.username${{ github.actor}}
bamboo.repository.branch.name${{ github.ref }}
bamboo.repository.git.branch${{ github.ref }}
bamboo.repository.git.repositoryUrl${{ github.server }}/${{ github.repository }}
bamboo.repository.pr.key${{ github.event.pull_request.number }}
bamboo.repository.pr.sourceBranch${{ github.event.pull_request.head.ref }}
bamboo.repository.pr.targetBranch${{ github.event.pull_request.base.ref }}
bamboo.resultsUrl${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
bamboo.shortJobKey${{ github.job }}
bamboo.shortJobName${{ github.job }}
bamboo.shortPlanKey${{ github.workflow }}
bamboo.shortPlanName${{ github.workflow }}

참고: 알 수 없는 변수는 ${{ env.<variableName> }}(으)로 변환되며, 적절한 작업을 위해 env 하에서 대체 또는 추가되어야 합니다. 예를 들어 ${bamboo.jira.baseUrl}은(는) ${{ env.jira_baseUrl }}이(가) 됩니다.

시스템 변수

작업에 사용되는 시스템 변수는 해당하는 bash 셸 변수로 변환되며 사용 가능한 것으로 간주됩니다. 예를 들어 ${system.<variable.name>}은(는) $variable_name(으)로 변환됩니다. 워크플로를 적절하게 작업하려면 이를 확인하는 것이 좋습니다.

부분은 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.