{"meta":{"title":"추가 인수 및 설정","intro":"GitHub Actions Importer 에는 마이그레이션 프로세스를 요구에 맞게 조정하는 몇 가지 추가 인수 및 설정이 있습니다.","product":"GitHub Actions","breadcrumbs":[{"href":"/ko/actions","title":"GitHub Actions"},{"href":"/ko/actions/reference","title":"참조"},{"href":"/ko/actions/reference/github-actions-importer","title":"GitHub Actions 가져오기"},{"href":"/ko/actions/reference/github-actions-importer/supplemental-arguments-and-settings","title":"추가 인수 및 설정"}],"documentType":"article"},"body":"# 추가 인수 및 설정\n\nGitHub Actions Importer 에는 마이그레이션 프로세스를 요구에 맞게 조정하는 몇 가지 추가 인수 및 설정이 있습니다.\n\n이 문서에서는 선택적 매개 변수, 경로 인수 및 네트워크 설정과 같은 추가 인수 및 설정을 구성 GitHub Actions Importer하기 위한 일반적인 정보를 제공합니다.\n\n## 선택적 매개 변수\n\nGitHub Actions Importer 에는 마이그레이션 프로세스를 사용자 지정하는 데 사용할 수 있는 몇 가지 선택적 매개 변수가 있습니다.\n\n### 허용되는 작업 제한하기\n\n다음 옵션을 사용하여 변환된 워크플로에서 허용되는 작업을 제한할 수 있습니다. 이러한 옵션을 함께 사용하면 허용된 작업 목록이 확장됩니다. 이러한 옵션을 제공하지 않으면 모든 작업이 허용됩니다.\n\n* `--allowed-actions`이(가) 변환된 워크플로에서 허용할 작업 목록을 지정합니다. 와일드카드가 지원됩니다. 제공된 작업 이외의 다른 작업은 허용되지 않습니다.\n\n  예시:\n\n  ```shell\n  --allowed-actions actions/checkout@v6 actions/upload-artifact@* my-org/*\n  ```\n\n  빈 목록을 제공하여 모든 작업이 허용되지 않도록 할 수 있습니다. 예: `--allowed-actions=`.\n\n* `--allow-verified-actions`은(는) 확인된 작성자의 모든 작업이 허용되도록 지정합니다.\n\n* `--allow-github-created-actions`은(는) `github` 또는 `actions` 조직에서 게시한 작업이 허용되도록 지정합니다.\n\n  예를 들어 이러한 작업에는 `github/super-linter` 및 `actions/checkout` 같은 작업이 포함됩니다.\n\n  이 옵션은 `--allowed-actions actions/* github/*`을(를) 실행하는 것과 동일합니다.\n\n### 인증에 자격 증명 파일 사용하기\n\n`--credentials-file` 매개 변수는 GitHub Actions Importer가 인증할 수 있는 여러 서버에 대한 자격 증명이 포함된 파일의 경로를 지정합니다. 빌드 스크립트(예: `.travis.yml` 또는 `jenkinsfile`)가 여러 GitHub Enterprise Server 인스턴스에 저장될 때 유용합니다.\n\n자격 증명 파일은 서버 목록과 액세스 토큰 조합이 포함된 YAML 파일이어야 합니다. \nGitHub Actions Importer 는 만드는 네트워크 요청과 가장 밀접하게 일치하는 URL에 대한 자격 증명을 사용합니다.\n\n예시:\n\n```yaml\n- url: https://github.com\n  access_token: ghp_mygeneraltoken\n- url: https://github.com/specific_org/\n  access_token: ghp_myorgspecifictoken\n- url: https://jenkins.org\n  access_token: abc123\n  username: marty_mcfly\n```\n\n위의 자격 증명 파일의 경우, GitHub Actions Importer는 `ghp_mygeneraltoken` 조직의 리포지토리에 대한 네트워크 요청인 경우를 제외하고 `specific_org` 액세스 토큰을 사용하여 `https://github.com`에 대한 모든 네트워크 요청을 인증합니다. 이 경우 `ghp_myorgspecifictoken` 토큰이 대신 인증에 사용됩니다.\n\n#### 대체 소스 제어 공급자\n\nGitHub Actions Importer 는 비 리GitHub 포지토리에서 소스 코드를 자동으로 가져올 수 있습니다. 자격 증명 파일은 소스 코드를 검색하는 데 필요한 `provider`, 공급자 URL 및 자격 증명을 지정할 수 있습니다.\n\n예시:\n\n```yaml\n- url: https://gitlab.com\n  access_token: super_secret_token\n  provider: gitlab\n```\n\n위의 예제에서는 GitHub Actions Importer는 `super_secret_token` 토큰을 사용하여 `https://gitlab.com`에 호스팅된 모든 소스 코드를 검색합니다.\n\n`provider`에 대해 지원되는 값은 다음과 같습니다.\n\n* `github`(기본값)\n* `gitlab`\n* `bitbucket_server`\n* `azure_devops`\n\n### 선택적 기능 제어하기\n\n`--features` 옵션을 사용하여 GitHub Actions Importer가 만드는 워크플로에서 사용되는 기능을 제한할 수 있습니다. 이는 이전 GitHub Actions 인스턴스로 GitHub Enterprise Server 마이그레이션할 때 워크플로에서 최신 구문을 제외하는 데 유용합니다. \n`--features` 옵션을 사용하는 경우 마이그레이션할 GitHub Enterprise Server의 버전을 지정해야 합니다.\n\n예시:\n\n```shell\ngh actions-importer dry-run ... --features ghes-3.3\n```\n\n`--features`에 대해 지원되는 값은 다음과 같습니다.\n\n* `all`(기본값)\n* `ghes-latest`\n* `ghes-<number>`, 여기서 `<number>`은(는) `3.0`의 버전이며 GitHub Enterprise Server 이상입니다. 예: `ghes-3.3`.\n\n`list-features` 명령을 실행하여 GitHub Actions Importer에 사용 가능한 기능 플래그 목록을 볼 수 있습니다. 예시:\n\n```shell copy\ngh actions-importer list-features\n```\n\n다음과 유사한 결과가 표시됩니다.\n\n<!-- markdownlint-disable search-replace -->\n\n```shell\nAvailable feature flags:\n\nactions/cache (disabled):\n        Control usage of actions/cache inside of workflows. Outputs a comment if not enabled.\n        GitHub Enterprise Server >= ghes-3.5 required.\n\ncomposite-actions (enabled):\n        Minimizes resulting workflow complexity through the use of composite actions. See https://docs.github.com/en/actions/creating-actions/creating-a-composite-action for more information.\n        GitHub Enterprise Server >= ghes-3.4 required.\n\nreusable-workflows (disabled):\n        Avoid duplication by re-using existing workflows. See https://docs.github.com/en/actions/using-workflows/reusing-workflows for more information.\n        GitHub Enterprise Server >= ghes-3.4 required.\n\nworkflow-concurrency-option-allowed (enabled):\n        Allows the use of the `concurrency` option in workflows. See https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#concurrency for more information.\n        GitHub Enterprise Server >= ghes-3.2 required.\n\nEnable features by passing --enable-features feature-1 feature-2\nDisable features by passing --disable-features feature-1 feature-2\n```\n\n<!-- markdownlint-enable search-replace -->\n\n기능 플래그를 토글하려면 다음 방법 중 하나를 사용할 수 있습니다.\n* `--enable-features` 및 `--disable-features` 옵션을 사용해 `gh actions-importer` 명령을 실행합니다.\n* 각 기능 플래그에 환경 변수를 사용합니다.\n\n`--enable-features` 및 `--disable-features` 옵션을 사용해 명령 기간 동안 특정 기능을 사용하거나 사용하지 않도록 선택할 수 있습니다.\n예를 들어 다음 명령은 `actions/cache` 및 `composite-actions`을(를) 사용 중지합니다.\n\n```shell\ngh actions-importer dry-run ... --disable-features=composite-actions actions/cache\n```\n\n`configure --features` 명령을 사용하여 기능 플래그를 대화형으로 구성하고 사용자 환경에 자동으로 쓸 수 있습니다.\n\n```shell\n$ gh actions-importer configure --features\n\n✔ Which features would you like to configure?: actions/cache, reusable-workflows\n✔ actions/cache (disabled): Enable\n? reusable-workflows (disabled):\n› Enable\n  Disable\n```\n\n### 네트워크 응답 캐싱을 사용 중지하기\n\n기본적으로 GitHub Actions Importer 네트워크 요청의 응답을 캐시하여 네트워크 부하를 줄이고 런타임을 줄입니다. \n`--no-http-cache` 옵션을 사용하여 네트워크 캐시를 사용 중지할 수 있습니다. 예시:\n\n```shell\ngh actions-importer forecast ... --no-http-cache\n```\n\n## 경로 인자\n\n실행할 GitHub Actions Importer때 경로 인수는 컨테이너의 디스크를 기준으로 하므로 컨테이너의 호스트 컴퓨터에 상대적인 절대 경로는 지원되지 않습니다. \nGitHub Actions Importer 실행되면 컨테이너의 `/data` 디렉터리가 실행되는 디렉터리에 GitHub Actions Importer 탑재됩니다.\n\n예를 들어 다음 명령은 디렉터리에서 `/Users/mona` 사용되는 경우 감사 요약 `/Users/mona/out` 을 GitHub Actions Importer 디렉터리에 출력합니다.\n\n```shell\ngh actions-importer audit --output-dir /data/out\n```\n\n## 프록시 사용하기\n\nHTTP 프록시로 구성된 서버에 액세스하려면 프록시의 URL을 사용하여 다음 환경 변수를 설정해야 합니다.\n\n* `OCTOKIT_PROXY`: 모든 GitHub 서버에 대해.\n* `HTTP_PROXY`(또는 `HTTPS_PROXY`): 다른 서버의 경우.\n\n예시:\n\n```shell\nexport OCTOKIT_PROXY=https://proxy.example.com:8443\nexport HTTPS_PROXY=$OCTOKIT_PROXY\n```\n\n프록시에 인증이 필요한 경우 사용자 이름과 암호가 프록시 URL에 포함되어야 합니다. 예: `https://username:password@proxy.url:port`.\n\n## SSL 인증서 확인 사용 중지하기\n\n기본적으로 GitHub Actions Importer 네트워크 요청을 할 때 SSL 인증서를 확인합니다. \n`--no-ssl-verify` 옵션을 사용하여 SSL 인증서 확인을 사용 중지할 수 있습니다. 예시:\n\n```shell\ngh actions-importer audit --output-dir ./output --no-ssl-verify\n```\n\n## 법적 고지\n\n부분은 MIT 라이선스에 따라 https://github.com/github/gh-actions-importer/에서 조정되었습니다.\n\n```text\nMIT License\n\nCopyright (c) 2022 GitHub\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```"}