GitHub 작업은 어떻게 작동합니까?

오늘 나는 GitHub Actions를 이해하려고 노력하면서 약간 길을 잃은 느낌이 들었습니다.

특히 documentation에는 작업이 어떻게 구성되고 무엇으로 구성되는지에 대한 개요가 없는 것으로 보입니다. 달리는 것들은 무엇입니까? 그것들은 어떻게 명명되고 참조됩니까?

돌이켜보면 문서 대신 Simple workflow 에 대한 yaml을 살펴보는 것으로 시작하는 것이 좋습니다. 이 버튼은 새 리포지토리의 작업 탭에 나타납니다.



이 버튼은 편집기에서 워크플로 yaml을 엽니다(아직 저장소에 커밋되지 않음).

결국 그렇게 신비하지 않습니다 😀

The first takeaway is that actions can be written using simple shell commands.

commonly used tools 이 사전 설치된 VM의 셸에서 명령이 실행됩니다. 새로운 스크립팅 언어를 배울 필요가 없습니다. 작업을 파일에 셸 스크립트로 작성하고 워크플로 yaml에서 호출할 수도 있습니다.

원하는 경우 다른 작업 흐름에서 작업의 일부를 패키징하고 재사용할 수 있습니다. 이러한 구성 요소는 actions이라고도 합니다(처음 혼동이 발생한 부분이 있습니다). 하지만 자신만의 워크플로를 구축하기 위해 직접 작성하는 방법을 배울 필요는 없습니다.

yaml에 흔들리지 마세요

각 작업은 키로 식별됩니다. simple-job 아래 예에서.
workflow syntax 문서에서는 이를 jobs.<job-id> 로 표시합니다.

on: push
jobs:
  simple-job:
    runs-on: ubuntu-latest
    env:
      HELLO: world
    steps:
    - run: 'echo Hello: $HELLO'
    - run: |
        echo node version: `node -v`
        pwd

steps:에는 각각 run:로 설명되는 명령 목록이 포함되어 있습니다.
(위의 이전 예에는 uses: 대신 run: 로 설명된 action 도 있습니다.)

위의 1st run: 명령은 ": "가 yaml 맵으로 해석되는 것을 방지하기 위해 인용됩니다.

두 번째 실행: "|"를 사용하여 여러 줄(들여쓰기) 블록에 2개의 명령을 포함합니다. 이 구문에는 따옴표가 필요하지 않으므로 포함된 스크립트에 편리합니다.

위의 워크플로를 GitHub의 새 리포지토리로 푸시하면 결과는 다음과 같아야 합니다.

yaml에 대해 알아야 할 몇 가지 사항

yamlonline의 유효성을 테스트할 수 있습니다.
JSON 표현을 보면 혼란이 해소되는 경우가 많습니다.

(스칼라) 문자열 주변의 따옴표는 선택 사항이지만 많은 문제가 있습니다!
예를 들어 시작 부분에 '-', 중간에 ':' 또는 '#' 또는 끝에 ':'이 있는 문자열 또는 숫자나 부울처럼 보이는 문자열을 찾으십시오.

맵은 일반적으로 같은 들여쓰기에서 key: value 줄로 작성됩니다.
목록은 일반적으로 - value 가 포함된 줄로 작성됩니다.
또는 지도에는 {key1: v1, key2: v2, ...}를, 목록에는 [v1, v2, ...]를 사용합니다.

들여쓰기에는 공백(탭 없음)을 사용해야 합니다.

여러 줄 문자열에 대한 자세한 내용은 https://yaml-multiline.info/을 참조하십시오.

GitHub Actions로 재미있게 놀아보세요!