사용자 지정 액션 및 마켓플레이스
미리 만들어진 액션을 제공하는 GitHub Actions 마켓플레이스를 살펴보고 직접 사용자 지정 액션을 만드는 방법을 배우세요.
사용자 지정 액션 및 마켓플레이스은(는) CoddyKit의 무료 DevOps Bootcamp 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 DevOps Bootcamp 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.
GitHub Actions Marketplace 알아보기
GitHub Actions Marketplace에 오신 것을 환영합니다! GitHub, 오픈 소스 기여자, 상용 파트너가 만든 수천 개의 미리 구축된 액션을 찾을 수 있는 활기찬 공간입니다.
이러한 액션은 워크플로에 쉽게 통합할 수 있으므로 일반적인 작업에 기존 솔루션을 재사용하여 시간과 노력을 절약할 수 있습니다.
적합한 액션 찾기
Marketplace를 탐색하는 방법은 간단합니다. 키워드로 액션을 검색하고, 카테고리(예: 'CI/CD' 또는 '배포')로 필터링하고, 인기도순으로 정렬할 수 있습니다.
- 별점이 높고 활발하게 유지 관리되는 액션을 찾아보세요.
- 액션의 문서에서 사용 방법, 입력, 출력을 확인하세요.
- 사회적 검증을 위해 공개 저장소에서 해당 액션이 사용된 횟수를 확인하세요.
기성 액션 통합하기
Marketplace 액션을 사용하는 방법은 간단합니다. 워크플로 YAML에서 uses 키워드 뒤에 액션의 소유자/저장소@버전을 지정해 참조합니다.
일반적인 예로 actions/checkout이 있습니다. 이 액션은 워크플로가 코드에 접근할 수 있도록 저장소의 코드를 체크아웃합니다.
name: Marketplace Demo
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Say hello
run: echo "Hello from workflow!"액션 입력 및 출력
많은 액션은 with 키워드를 사용해 지정하는 입력을 받아 동작을 사용자 지정할 수 있습니다. 또한 워크플로의 다른 단계에서 사용할 수 있는 출력을 생성할 수도 있습니다.
예를 들어 actions/setup-node 액션은 node-version 입력을 받을 수 있습니다.
name: Node Setup Demo
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Node.js 18.x
uses: actions/setup-node@v3
with:
node-version: '18.x'
- name: Install dependencies
run: npm install직접 액션을 만들어야 할 때
Marketplace에는 다양한 액션이 있지만, 때로는 특정한 기능이 필요합니다. 이럴 때 사용자 지정 액션이 유용합니다!
다음과 같은 경우 사용자 지정 액션을 만들 수 있습니다.
- 회사 내부 도구 자동화
- 기존 액션에서 지원하지 않는 고유한 API 통합
- 프로젝트의 빌드 프로세스에 특화된 고도로 전문적인 작업 수행
사용자 지정 액션 유형
만들 수 있는 사용자 지정 액션에는 두 가지 주요 유형이 있습니다.
- JavaScript 액션: 실행기 컴퓨터에서 Node.js를 사용해 직접 실행됩니다. 일반적으로 개발이 더 빠르고 공유하기도 쉽습니다.
- Docker 컨테이너 액션: Docker 컨테이너 내부에서 실행됩니다. 환경과 종속 항목을 캡슐화하여 실행기마다 일관되게 실행할 수 있다는 장점이 있습니다.
간단하게 설명하기 위해 JavaScript 액션에 집중하겠습니다.
`action.yml` 파일
모든 사용자 지정 액션에는 action.yml 파일이 필요합니다. 이 파일은 이름, 설명, 허용하는 입력, 생성하는 출력, 실행 방법을 비롯한 액션의 메타데이터를 정의합니다.
GitHub Actions에 액션에 대해 알아야 할 모든 것을 알려 주는 매니페스트와 같습니다.
name: 'My Custom Greeting Action'
description: 'Greets a person with a custom message.'
inputs:
who-to-greet:
description: 'Who to greet'
required: true
default: 'World'
outputs:
time:
description: 'The time we greeted you'
runs:
using: 'node16'
main: 'index.js'간단한 JavaScript 액션 만들기
아주 기본적인 JavaScript 액션을 만들어 보겠습니다. action.yml에 지정할 index.js 파일과 일반적으로 종속 항목을 위한 package.json 파일이 필요합니다.
@actions/core 패키지는 입력을 가져오고 출력을 설정하는 등 워크플로와 상호 작용하는 데 필수적입니다.
const core = require('@actions/core');
async function run() {
try {
const nameToGreet = core.getInput('who-to-greet');
console.log(`Hello ${nameToGreet}!`);
const time = (new Date()).toTimeString();
core.setOutput("time", time);
} catch (error) {
core.setFailed(error.message);
}
}
run();사용자 지정 액션 통합하기
사용자 지정 액션을 사용하려면 해당 파일(action.yml, index.js 등)을 저장소 내 하위 디렉터리에 배치하세요. 그런 다음 uses: ./path/to/your/action과 같은 상대 경로를 사용해 워크플로에서 참조합니다.
이렇게 하면 Marketplace에 게시하기 전에 로컬에서 액션을 테스트할 수 있습니다.
name: Use Custom Action Demo
on: [push]
jobs:
greet:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run my custom action
uses: ./my-custom-action # Path to action directory
with:
who-to-greet: 'CoddyKit User'
- name: Get the output time
run: echo "The greeting time was ${{ steps.run-my-custom-action.outputs.time }}"사용자 지정 액션 구성 요소
사용자 지정 GitHub Actions를 만들고 사용하는 데 필요한 핵심 요소를 배웠습니다. 제대로 이해했는지 확인해 보겠습니다!
Marketplace 및 사용자 지정 액션 복습
잘하셨습니다! GitHub Actions Marketplace와 사용자 지정 액션의 강력한 기능을 모두 살펴보았습니다.
- Marketplace는 워크플로를 간소화할 수 있는 다양한 즉시 사용 가능한 액션을 제공합니다.
- 사용자 지정 액션을 사용하면 고유한 프로젝트 또는 조직의 요구 사항에 맞게 GitHub Actions를 확장할 수 있습니다.
이 둘을 결합하면 매우 강력하고 맞춤화된 자동화 파이프라인을 구축할 수 있습니다!
자주 묻는 질문
“사용자 지정 액션 및 마켓플레이스” 강의는 무료인가요?
네 — “사용자 지정 액션 및 마켓플레이스” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 DevOps Bootcamp 강의 전체를 잠금 해제할 수 있습니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.
“사용자 지정 액션 및 마켓플레이스”에서 뭘 배우나요?
미리 만들어진 액션을 제공하는 GitHub Actions 마켓플레이스를 살펴보고 직접 사용자 지정 액션을 만드는 방법을 배우세요. 브라우저에서 직접 실행하는 실습 코드로 DevOps Bootcamp을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
DevOps Bootcamp을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 DevOps Bootcamp은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“사용자 지정 액션 및 마켓플레이스” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 DevOps Bootcamp 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 DevOps Bootcamp 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- GitHub Actions 입문
- CI/CD 워크플로 구축
- 사용자 지정 액션 및 마켓플레이스
- Actions의 보안 비밀과 환경 변수