Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/harness/harness-migrate
Harness CI migration utility
https://github.com/harness/harness-migrate
continuous-integration golang
Last synced: about 2 months ago
JSON representation
Harness CI migration utility
- Host: GitHub
- URL: https://github.com/harness/harness-migrate
- Owner: harness
- License: apache-2.0
- Created: 2023-02-09T00:01:36.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-11-07T00:01:28.000Z (about 2 months ago)
- Last Synced: 2024-11-07T01:17:37.834Z (about 2 months ago)
- Topics: continuous-integration, golang
- Language: Go
- Homepage: https://www.harness.io/products/continuous-integration
- Size: 15.2 MB
- Stars: 9
- Watchers: 2
- Forks: 4
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Harness Migrator
**harness-migrate** is a command line utility to help convert and migrate
continuous integration pipelines from other providers to Harness CI. You can use this tool to migrate repositories following guidlines [below](#migrate-repositories).
**Please review [known conversion and migration issues](KNOWN_ISSUES_CONVERT.md
) before using this tool.**
## Migrate Repositories
Migrating repositoires is a two-step process.
1. Export: Use `git-export` to export your repositories from your current provider. Guidlines for [Bitbucket On-perm](cmd/stash/README.md), [GitHub](cmd/github/README.md), [Gitlab](cmd/gitlab/README.md); support for Bitbucket will be added. The exported data will be saved in a zip file.
2. Import: Import the exported zip file into Harness using `git-import` to create new repositories as explained [here](cmd/gitimporter/README.md).
## Migrate Continuous Integration Pipelines
## Install on Mac
Intel CPU
```sh
curl -L https://github.com/harness/harness-migrate/releases/latest/download/harness-migrate-darwin-amd64.tar.gz | tar zx
```
Apple silicon (M1 or M2) CPU
```sh
curl -L https://github.com/harness/harness-migrate/releases/latest/download/harness-migrate-darwin-arm64.tar.gz | tar zx
```
Copy the binary into place
```sh
sudo cp harness-migrate /usr/local/bin
```
Verify the install
```sh
harness-migrate --help
```
## Build
```term
$ git clone https://github.com/harness/harness-migrate.git
$ cd harness-migrate
$ go build
```
## Usage
### Drone
Convert a drone pipeline:
```term
harness-migrate drone convert /path/to/.drone.yml
```
Export a github namespace from drone:
```term
harness-migrate drone export \
--namespace example \
--github-token $GITHUB_TOKEN \
export.json
```
❗ To avoid pipelines triggering in both your Drone instance and in Harness CI, you must first deactivate the pipelines in your Drone instance.
This script uses [jq](https://jqlang.github.io/jq/) and the [Drone CLI](https://docs.drone.io/cli/install/) to disable all pipelines defined in your `export.json`:
```bash
#!/bin/bash
DRONE_NAMESPACE=$(jq -r .name export.json)
for REPO_NAME in $(jq -r .project[].name export.json); do
drone repo disable $DRONE_NAMESPACE/$REPO_NAME
done
```
Import a drone namespace:
```term
harness-migrate drone import \
--harness-account $HARNESS_ACCOUNT \
--harness-org example \
--docker-connector account.harnessImage \
--github-token $GITHUB_TOKEN \
export.json
```
### BitBucket
Convert a bitbucket pipeline:
```term
harness-migrate bitbucket convert /path/to/bitbucket-pipelines.yml
```
### CircleCI
Convert a circle pipeline:
```term
harness-migrate circle convert /path/to/.circle/config.yml
```
### GitHub Actions
Convert a github pipeline:
```term
harness-migrate github convert /path/to/.github/workflows/main.yml
```
### GitLab
Convert a gitlab pipeline:
```term
harness-migrate gitlab convert /path/to/.gitlab-ci.yml
```
### Terraform
Generate terraform configuration from an export, and apply it to your Harness account:
```term
$ harness-migrate terraform \
--account $HARNESS_ACCOUNT \
--docker-connector account.harnessImage \
--org $HARNESS_ORG \
--repo-connector $HARNESS_REPO_CONNECTOR \
export.json \
output.tf
$ terraform init
$ terraform apply
```