사용자 지정 작업 정보

사용자 지정 작업 정보

GitHub의 API 및 공개적으로 사용 가능한 타사 API와의 통합을 포함하여 원하는 방식으로 리포지토리와 상호 작용하는 사용자 지정 코드를 써서 작업을 만들 수 있습니다. 예를 들어 작업은 npm 모듈을 게시할 수 있고 긴급한 이슈가 발생할 때 SMS 알림을 보낼 수 있으며 프로덕션 준비 코드를 배포할 수 있습니다.

작업은 머신 또는 Docker 컨테이너에서 직접 실행할 수 있습니다. 작업의 입력, 출력, 환경 변수를 정의할 수 있습니다.

동작 유형

Docker 컨테이너, JavaScript 및 복합 작업을 빌드할 수 있습니다. 작업에는 작업에 대한 입력, 출력, 기본 진입점을 정의하는 메타데이터 파일이 필요합니다. 메타데이터 파일 이름은 action.yml 또는 action.yaml이어야 합니다. 자세한 내용은 "GitHub Actions에 대한 메타데이터 구문"을(를) 참조하세요.

Docker 컨테이너 작업

Docker 컨테이너는 GitHub Actions 코드로 환경을 패키지합니다. 이렇게 하면 작업 소비자가 도구 또는 종속성에 대해 걱정할 필요가 없으므로 더 일관되고 안정적인 작업 단위가 만들어집니다.

Docker 컨테이너를 사용하면 운영 체제, 종속성, 도구, 코드의 특정 버전을 사용할 수 있습니다. 특정 환경 구성에서 실행해야 하는 작업의 경우 운영 체제 및 도구를 사용자 지정할 수 있으므로 Docker가 이상적인 옵션입니다. 컨테이너를 빌드하고 검색하는 데 드는 대기 시간으로 인해 Docker 컨테이너 작업이 JavaScript 작업보다 느립니다.

Docker 컨테이너 작업은 Linux 운영 체제를 사용하는 실행기에서만 실행할 수 있습니다. 자체 호스팅 실행기는 Linux 운영 체제를 사용해야 하며 Docker 컨테이너 작업을 실행하기 위해 Docker가 설치되어 있어야 합니다. 자체 호스트 실행기의 요구 사항에 대한 자세한 내용은 “자체 호스트형 실행기 정보”를 참조하세요.

JavaScript 작업

JavaScript 작업은 실행기 머신에서 직접 실행할 수 있으며 코드를 실행하는 데 사용되는 환경에서 작업 코드를 분리할 수 있습니다. JavaScript 작업을 사용하면 작업 코드가 간소화되고 Docker 컨테이너 작업보다 빠르게 실행됩니다.

JavaScript 작업이 모든 GitHub 호스트된 실행기(Ubuntu, Windows 및 macOS)와 호환되도록 하려면 작성하는 패키지된 JavaScript 코드는 순수 JavaScript이고 다른 이진 파일에 의존하지 않아야 합니다. JavaScript 작업은 실행기에서 직접 실행되며 실행기 이미지에 이미 있는 이진 파일을 사용합니다.

Node.js 프로젝트를 개발하는 경우 GitHub Actions 도구 키트는 개발 속도를 높이기 위해 프로젝트에서 사용할 수 있는 패키지를 제공합니다. 자세한 내용은 actions/toolkit 리포지토리를 참조하세요.

복합 작업

복합 작업을 사용하면 하나의 작업 내에서 여러 워크플로 단계를 결합할 수 있습니다.__ 예를 들어 이 기능을 사용하여 여러 실행 명령을 작업으로 함께 묶은 다음 해당 작업을 사용하여 함께 묶인 명령을 단일 단계로 실행하는 워크플로를 사용할 수 있습니다. 예를 보려면 "복합 작업 만들기"을(를) 검사합니다.

작업 위치 선택

다른 사람이 사용할 작업을 개발하는 경우 작업을 다른 애플리케이션 코드와 함께 묶는 대신 자체 리포지토리에 유지하는 것이 좋습니다. 이를 통해 다른 소프트웨어처럼 작업을 버전 관리하고, 추적하고, 릴리스할 수 있습니다.

작업을 공개적으로 게시하지 않고 엔터프라이즈에서 작업을 공유하려면 내부 리포지토리에 작업을 저장한 다음, 엔터프라이즈 내 동일한 조직 또는 모든 조직이 소유한 다른 리포지토리의 GitHub Actions 워크플로에 액세스할 수 있도록 리포지토리를 구성하면 됩니다. 자세한 정보는 "엔터프라이즈와 작업 및 워크플로 공유"을(를) 참조하세요.

단일 리포지토리에서 작업, 워크플로, 애플리케이션 코드를 결합하려는 경우 작업을 .github 디렉터리에 저장하는 것이 좋습니다. 예를 들어 .github/actions/action-a 및 .github/actions/action-b를 지정합니다.

다른 플랫폼과의 호환성 보장

많은 사람들이 GitHub.com 이외의 도메인(예: GHE.com 또는 GitHub Enterprise Server에 대한 사용자 지정 도메인)에서 GitHub에 액세스합니다.

작업이 다른 플랫폼과 호환되도록 하려면 API URL(예: https://api.github.com)에 대해 하드 코딩된 참조는 사용하지 마세요. 대신 다음을 사용할 수 있습니다.

• 환경 변수 사용("변수에 정보 저장" 참조):

  • REST API의 경우 GITHUB_API_URL 환경 변수를 사용합니다.
  • GraphQL의 경우 GITHUB_GRAPHQL_URL 환경 변수를 사용합니다.

• 올바른 URL을 자동으로 설정할 수 있는 @actions/github와 같은 도구 키트를 사용합니다.

작업에 릴리스 관리 사용

이 섹션에서는 릴리스 관리를 사용하여 예측 가능한 방식으로 작업에 대한 업데이트를 배포하는 방법을 설명합니다.

릴리스 관리 모범 사례

다른 사람이 사용할 작업을 개발하는 경우 릴리스 관리를 사용하여 업데이트를 배포하는 방법을 제어하는 것이 좋습니다. 사용자는 작업의 패치 버전에 필요한 중요 수정 사항 및 보안 패치가 포함되어 있으면서도 기존 워크플로와 계속 호환될 것으로 기대할 수 있습니다. 변경 내용이 호환성에 영향을 미칠 때마다 새 주 버전을 릴리스하는 것이 좋습니다.

이 릴리스 관리 접근 방식에서는 사용자가 작업의 기본 분기를 참조해서는 안 됩니다. 최신 코드를 포함할 가능성이 크고 결과적으로 불안정할 수 있기 때문입니다. 대신, 사용자가 작업을 사용할 때 주 버전을 지정하고 문제가 발생하는 경우에만 더 구체적인 버전으로 안내하도록 하는 것이 좋습니다.

특정 작업 버전을 사용하기 위해 사용자는 태그, 커밋의 SHA 또는 릴리스에 대해 명명된 분기를 대상으로 하도록 GitHub Actions 워크플로를 구성할 수 있습니다.

릴리스 관리에 태그 사용

작업 릴리스 관리에 태그를 사용하는 것이 좋습니다. 이 방법을 사용하면 사용자가 주 버전과 부 버전을 쉽게 구분할 수 있습니다.

• 릴리스 태그(예: v1.0.2)를 만들기 전에 릴리스 분기(예: release/v1)에서 릴리스를 만들고 유효성을 검사합니다.
• 의미 체계 버전 관리를 사용하여 릴리스를 만듭니다. 자세한 내용은 "리포지토리에서 릴리스 관리"을(를) 참조하세요.
• 주 버전 태그(예: v1, v2)를 이동하여 현재 릴리스의 Git 참조를 가리킵니다. 자세한 내용은 “Git 기본 사항 - 태그 지정”을 참조하세요.
• 기존 워크플로를 중단하는 변경 내용에 대해 새 주 버전 태그(v2)를 도입합니다. 예를 들어 작업의 입력을 변경하는 것은 호환성이 손상되는 변경입니다.
• 주 버전은 처음에 상태를 나타내기 위해 beta 태그(예: v2-beta)를 사용하여 릴리스될 수 있습니다. -beta 태그는 준비가 되면 제거할 수 있습니다.

이 예제에서는 사용자가 주 릴리스 태그를 참조하는 방법을 보여 줍니다.

steps:
    - uses: actions/javascript-action@v1

이 예제에서는 사용자가 특정 패치 릴리스 태그를 참조하는 방법을 보여 줍니다.

steps:
    - uses: actions/javascript-action@v1.0.1

릴리스 관리에 분기 사용

릴리스 관리에 분기 이름을 사용하려는 경우 이 예제에서는 명명된 분기를 참조하는 방법을 보여 줍니다.

steps:
    - uses: actions/javascript-action@v1-beta

릴리스 관리에 커밋의 SHA 사용

각 Git 커밋은 고유하고 변경할 수 없는 계산된 SHA 값을 수신합니다. 이 방법은 삭제되거나 이동할 수 있는 태그를 지정하는 것보다 더 안정적일 수 있으므로 작업의 사용자는 커밋의 SHA 값에 의존하는 것을 선호할 수 있습니다. 그러나 이는 사용자가 작업에 대한 추가 업데이트를 받지 못한다는 것을 의미합니다. 약식 값이 아닌 커밋의 전체 SHA 값을 사용해야 합니다.

steps:
    - uses: actions/javascript-action@a824008085750b8e136effc585c3cd6082bd575f

작업에 대한 추가 정보 파일 만들기

사용자가 작업을 사용하는 방법을 배울 수 있도록 추가 정보 파일을 만드는 것이 좋습니다. 이 정보를 README.md에 포함할 수 있습니다.

• 작업이 수행하는 작업에 대한 자세한 설명
• 필수 입력 및 출력 인수
• 선택적 입력 및 출력 인수
• 작업에서 사용하는 비밀
• 작업에서 사용하는 환경 변수
• 워크플로에서 작업을 사용하는 방법의 예제

GitHub Actions를 GitHub Apps과 비교

GitHub Marketplace는 워크플로를 개선하는 도구를 제공합니다. 각 도구의 차이점과 이점을 이해하면 작업에 가장 적합한 도구를 선택할 수 있습니다. 앱 빌드에 대한 자세한 내용은 "GitHub 앱 만들기 정보"을(를) 참조하세요.

GitHub Actions 및 GitHub 앱의 장점

GitHub Actions 및 GitHub Apps은 모두 자동화 및 워크플로 도구를 빌드하는 방법을 제공하지만 각기 다른 방식으로 유용한 장점이 있습니다.

GitHub Apps:

• 지속적으로 실행하고 이벤트에 신속하게 대응할 수 있습니다.
• 영구 데이터가 필요할 때 제대로 작동합니다.
• 시간이 오래 걸리지 않는 API 요청에 가장 잘 작동합니다.
• 제공하는 서버 또는 컴퓨팅 인프라에서 실행합니다.

GitHub Actions:

• 지속적인 통합 및 배포를 수행할 수 있는 자동화를 제공합니다.
• 실행기 머신 또는 Docker 컨테이너에서 직접 실행할 수 있습니다.
• 배포 및 게시 도구, 코드 포맷터, 명령줄 도구를 사용하여 코드에 액세스할 수 있도록 리포지토리의 복제본에 대한 액세스를 포함할 수 있습니다.
• 코드를 배포하거나 앱을 제공할 필요가 없습니다.
• 작업을 사용하는 사용자의 자격 증명을 저장하지 않고도 작업이 타사 서비스와 상호 작용할 수 있도록 비밀을 만들고 사용하는 간단한 인터페이스가 있습니다.

추가 참고 자료

• "GitHub Actions에 대한 워크플로 명령"