{"id":13560720,"url":"https://github.com/github/gh-valet","last_synced_at":"2025-10-04T07:31:25.852Z","repository":{"id":37227291,"uuid":"469970302","full_name":"github/gh-valet","owner":"github","description":"Valet helps facilitate the migration of Azure DevOps, CircleCI, GitLab CI, Jenkins, and Travis CI pipelines to GitHub Actions.","archived":true,"fork":false,"pushed_at":"2023-03-22T15:15:31.000Z","size":229,"stargazers_count":510,"open_issues_count":2,"forks_count":35,"subscribers_count":176,"default_branch":"main","last_synced_at":"2024-09-30T00:06:24.241Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/github.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null}},"created_at":"2022-03-15T01:57:46.000Z","updated_at":"2024-09-09T14:53:56.000Z","dependencies_parsed_at":"2023-02-04T15:16:56.728Z","dependency_job_id":null,"html_url":"https://github.com/github/gh-valet","commit_stats":{"total_commits":137,"total_committers":13,"mean_commits":"10.538461538461538","dds":"0.34306569343065696","last_synced_commit":"0e8c1752bae5bf5fe483c7b1927e647abf24f288"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fgh-valet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fgh-valet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fgh-valet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fgh-valet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/github","download_url":"https://codeload.github.com/github/gh-valet/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235227462,"owners_count":18956137,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T13:00:48.988Z","updated_at":"2025-10-04T07:31:20.496Z","avatar_url":"https://github.com/github.png","language":"C#","funding_links":[],"categories":["C# #","C#"],"sub_categories":[],"readme":"\u003e **Warning**: GitHub Actions Importer is now [generally available](gh.io/actions-importer-ga). You should use the CLI built in [github/gh-actions-importer](https://github.com/github/gh-actions-importer) repository instead of this repository moving forward.\n\n# GitHub Valet CLI\n\n[![.github/workflows/ci.yml](https://github.com/github/gh-valet/actions/workflows/ci.yml/badge.svg)](https://github.com/github/gh-valet/actions/workflows/ci.yml)\n\nValet helps facilitate the migration of Azure DevOps, CircleCI, GitLab CI, Jenkins, and Travis CI pipelines to GitHub Actions. This repository provides functionality that extends the [GitHub CLI](https://cli.github.com/) to migrate pipelines to GitHub Actions using Valet.\n\nYou can request support [here](https://support.github.com/).\n\n## Supported platforms\n\nValet currently supports migrating pipelines to GitHub Actions from the following platforms:\n\n- Azure DevOps\n- CircleCI\n- GitLab CI\n- Jenkins\n- Travis CI\n\nYou can find detailed information about how Valet works for each of the supported platforms in the documentation that is available once you are granted access.\n\n## Getting started with the Valet CLI\n\nValet is distributed as a Docker container and this extension to the official [GitHub CLI](https://cli.github.com) to interact with the Docker container.\n\n### Prerequisites\n\nThe following requirements must be met to be able to run Valet:\n\n- The Docker CLI must be [installed](https://docs.docker.com/get-docker/) and running\n- The official [GitHub CLI](https://cli.github.com) must be installed\n- You must have credentials to [authenticate](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry#authenticating-to-the-container-registry) with the GitHub Container Registry after you are granted access.\n\n### Installation\n\nNext, the Valet CLI extension can be installed via this command:\n\n```bash\n$ gh extension install github/gh-valet\n```\n\nTo verify the extension is installed, run this command:\n\n```bash\n$ gh valet -h\nDescription:\n  Valet is a tool to help plan and facilitate migrations to GitHub Actions.\n\nOptions:\n  -?, -h, --help  Show help and usage information\n\nCommands:\n  update    Update to the latest version of Valet\n  version   Check the version of the Valet docker container.\n  audit     An audit will output a list of data used in a CI/CD instance.\n  dry-run   Convert a pipeline to a GitHub Actions workflow and output its yaml file.\n  migrate   Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes.\n  forecast  Forecasts GitHub Actions usage from historical pipeline utilization.\n```\n\n### Configuration\n\nNew versions of Valet are released on a regular basis. To ensure you're always up to date, the following command should be run often:\n\n```bash\n$ gh valet update\n```\n\n**Note**: You will need to be authenticated with GitHub Container Registery for this command to be successful. Optionally, credentials can be provided to this command that will be used to authenticate on your behalf:\n\n```bash\n$ echo $GITHUB_TOKEN | gh valet update --username $GITHUB_HANDLE --password-stdin\n```\n\nIn order for Valet to communicate with your current CI server and GitHub, various credentials must be available for the command. These can be configured using environment variables or a `.env.local` file. These environment variables can be configured in an interative prompt by running the following command:\n\n```bash\n$ gh valet configure\n? Enter value for 'GITHUB_ACCESS_TOKEN' (leave empty to skip): \n...\n```\n\nYou can find detailed information about using environment variables in the documentation that is available once you are granted access.\n\n### Usage\n\nNow that Valet is configured and up-to-date, different subcommands of `gh valet` can be used to facilate a migration to GitHub Actions.\n\n#### Audit\n\nThe `audit` subcommand can be used to scan a CI server and output a summary of the current pipelines. This summary can then be used to plan timelines for migrating to GitHub Actions.\n\nTo run an audit, use the following command to determine the options that are relevant to your use case:\n\n```bash\n$ gh valet audit -h\nDescription:\n  An audit will output a list of data used in a CI/CD instance.\n\n\u003comitted for brevity\u003e\n\nCommands:\n  azure-devops  An audit will output a list of data used in an Azure DevOps instance.\n  circle-ci     An audit will output a list of data used in a CircleCI instance.\n  gitlab        An audit will output a list of data used in a GitLab instance.\n  jenkins       An audit will output a list of data used in a Jenkins instance.\n  travis-ci     An audit will output a list of data used in a Travis CI instance.\n```\n\nYou can find detailed information about running an audit with Valet in the documentation that is available once you are granted access.\n\n#### Forecast\n\nThe `forecast` subcommand can be used to forecast GitHub Actions usage from historical pipeline usage.\n\nTo run a forecast, use the following command to determine the options that are relevant to your use case:\n\n```bash\n$ gh valet forecast -h\nDescription:\n  Forecasts GitHub Actions usage from historical pipeline utilization.\n\n\u003comitted for brevity\u003e\n\nCommands:\n  azure-devops  Forecasts GitHub Actions usage from historical Azure DevOps pipeline utilization.\n  jenkins       Forecasts GitHub Actions usage from historical Jenkins pipeline utilization.\n  gitlab        Forecasts GitHub Actions usage from historical GitLab pipeline utilization.\n  circle-ci     Forecasts GitHub Actions usage from historical CircleCI pipeline utilization.\n  travis-ci     Forecasts GitHub Actions usage from historical Travis CI pipeline utilization.\n  github        Forecasts GitHub Actions usage from historical GitHub pipeline utilization.\n```\n\nYou can find detailed information about running a forecast with Valet in the documentation that is available once you are granted access.\n\n#### Dry-run\n\nThe `dry-run` subcommand can be used to convert a pipeline to its GitHub Actions equivalent and write the workflow to your local filesystem.\n\nTo run a dry-run, use the following command to determine the options that are relevant to your use case:\n\n```bash\n$ gh valet dry-run -h\nDescription:\n  Convert a pipeline to a GitHub Actions workflow and output its yaml file.\n\n\u003comitted for brevity\u003e\n\nCommands:\n  azure-devops  Convert an Azure DevOps pipeline to a GitHub Actions workflow and output its yaml file.\n  circle-ci     Convert a CircleCI pipeline to GitHub Actions workflows and output the yaml file(s).\n  gitlab        Convert a GitLab pipeline to a GitHub Actions workflow and output the yaml file.\n  jenkins       Convert a Jenkins job to a GitHub Actions workflow and output its yaml file.\n  travis-ci     Convert a Travis CI pipeline to a GitHub Actions workflow and output its yaml file.\n```\n\nYou can find detailed information about running a dry-run with Valet in the documentation that is available once you are granted access.\n\n#### Migrate\n\nThe `migrate` subcommand can be used to convert a pipeline to its GitHub Actions equivalent and then create a pull request with the contents.\n\nTo run a migration, use the following command to determine the options that are relevant to your use case:\n\n```bash\n$ gh valet migrate -h\nDescription:\n  Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes.\n\n\u003comitted for brevity\u003e\n\nCommands:\n  azure-devops  Convert an Azure DevOps pipeline to a GitHub Actions workflow and open a pull request with the changes.\n  circle-ci     Convert a CircleCI pipeline to GitHub Actions workflows and open a pull request with the changes.\n  gitlab        Convert a GitLab pipeline to a GitHub Actions workflow and open a pull request with the changes.\n  jenkins       Convert a Jenkins job to a GitHub Actions workflow and open a pull request with the changes.\n  travis-ci     Convert a Travis CI pipeline to a GitHub Actions workflow and and open a pull request with the changes.\n```\n\nYou can find detailed information about running a migration with Valet in the documentation that is available once you are granted access.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithub%2Fgh-valet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgithub%2Fgh-valet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithub%2Fgh-valet/lists"}