GitHub Handbook
Details regarding analysis performed on VA GHEC for migrations
Overview
An analysis was performed in early March 2025 of repositories in the department-of-veterans-affairs organization for the GitHub Enterprise Cloud (GHEC) instance to help determine migration readiness for migration over to the GHEC-US instance. The analysis has been summarized into a spreadsheet and details on how to view this spreadsheet are provided in this document.
Engineering teams can use this data to identify repository resources that will not be migrated by GitHub’s migration product, GitHub Enterprise Importer (GEI). Refer to the documentation at data that is not migrated for additional context. The GitHub team is working on additional support for some repository resources that are not migrated by GEI. See the parent migrations page for more details.
Spreadsheet
For any documentation mentioned in this page, refer to the following spreadsheet:
The spreadsheet provided is in .xlsx format and you will need Microsoft Excel in order to view the spreadsheet.
Data in the spreadsheet is formatted as a table and you can use table filters to filter, sort, and search for the
repositories specific to your team(s). Specifically refer to the data sheet for any data referenced. There is also a
copy of the data dictionary in the referenced spreadsheet as well.
Understanding Spreadsheet Values
When reviewing the spreadsheet, you may encounter the following values in cells. These values provide important information about migration readiness and potential issues:
| Value | Meaning |
|---|---|
TRUE |
The feature or condition is present in the repository. |
FALSE |
The feature or condition is not present in the repository. |
1+ |
The repository contains one or more instances of this item. |
Numeric value (e.g., 42) |
Indicates the exact count of items present (such as webhooks, alerts, or other countable resources). |
>X GB |
The repository contains more than X gigabytes of this resource, which may cause issues during migration. |
No problem |
The feature is used, but the amount of data will not impact migration. |
Column Descriptions
The following columns can be found in the spreadsheet.
| Column | Column Name | Column Description |
|---|---|---|
| A | Org_Name | The name of the GitHub organization that owns the repository. |
| B | Repo_Name | The name of the GitHub repository being analyzed. |
| C | isArchived | Indicates whether the repository has been archived (true/false). Archived repositories are read-only. |
| D | has_external_collaborators | Indicates whether the repository has collaborators from outside the organization (true/false). External collaborators will not be supported in GHEC-US. |
| E | issues_linked_to_projects | The number of issues in the repository that are associated with at least one project. Projects are not migrated by GEI but the GitHub team is working on additional support. |
| F | unique_projects_linked_by_issues | The number of projects one or more issues in the repository are linked to (based on issues_linked_to_projects). |
| G | projects_linked_to_repo | The number of projects explicitly linked to the repository via the “projects” tab (note: this is independent of projects that are linked by any issues in the repository). |
| H | app_installations | Number of GitHub Apps installed in this repository. GitHub Apps are not migrated. |
| I | repository-custom-properties | If this repository has one or more custom properties assigned to it. Custom properties are not migrated by GEI but the GitHub team is working on additional support. |
| J | repository-forks | If this repository has one or more forks. The forks will not be migrated automatically with this repository. If they are migrated separately, they will no longer be connected to the parent repository. |
| K | repository-rulesets | If there are one or more repository or organization rulesets that apply to this repository. Repository rulesets are not migrated by GEI but the GitHub team is working on additional support. |
| L | watchers | One or more users are watching this repository. Watchers will not be transferred as part of a migration. |
| M | repository-code-scanning-analyses | If this repository has one or more Code Scanning analyses. These will not be migrated. |
| N | repository-webhooks | The number of webhooks this repository has. These will be migrated but they will be disabled by default and their secrets will be wiped. The GitHub team is working on additional support to automatically reactivate webhooks that do not have secrets. |
| O | repository-code-scanning-alerts | If this repository has one or more Code Scanning alerts. These will not be migrated. |
| P | repository-secret-scanning-alerts | If the repository has one or more secret scanning alerts. These alerts and their states will not be migrated, so it is likely that the same secrets will be detected again, and then you’ll have to resolve them. |
| Q | repository-actions-workflow-runs | The number of GitHub Actions workflow runs for this repository. Actions workflows will be migrated but past runs are not. |
| R | repository-code-scanning-default-setup | If this repository has Code Scanning default setup configuration enabled. This will not be migrated, VA teams will need to reconfigure the default code scanning configuration after migration. |
| S | repository-dependabot-alerts | This repository has one or more Dependabot alerts. These will not be migrated. |
| T | repository-packages | The number of packages on this repository. Packages are not migrated by GEI but the GitHub team is working on additional support. |
| U | repository-releases-gt-5gb | If the repository includes more than 5 GB of release assets. This may slow down your migration, or block it by taking you over the migration tool’s file size limit. If this repository has release assets greater than 5 GB the current value is displayed in this column as well. Anything with a value greater than 10 GB will fail to migrate and the GitHub team will coordinate with these teams. |
| V | repository-disk-usage | The size on disk for this repository. Repository size can affect the amount of time required for a migration. Repositories over 40GB in size may not migrate successfully. |
| W | repository-deployments | The number of deployments on this repository. These will not be migrated. |
| X | repository-environments | The number of environments on this repository. Environments are not migrated by GEI but the GitHub team is working on additional support. |
| Y | git-lfs-objects | If the repository uses Git LFS. Git LFS Objects are not migrated by GEI but the GitHub team is working on additional support. |
| Z | repository-actions-secrets | The number of GitHub Actions secrets. Actions secrets are not migrated by GEI but the GitHub team is working on additional support (which would only include recreating the secrets with empty values - we do not have access to the secret values). |
| AA | repository-actions-self-hosted-runners | The number of GitHub Actions self-hosted runners. These will not be migrated. |
| AB | repository-dependabot-secrets | The number of Dependabot secrets for this repository. These will not be migrated. |
| AC | repository-actions-variables | The number of GitHub Actions variables for this repository. Actions variables are not migrated by GEI but the GitHub team is working on additional support. |
| AD | git-submodules | If the repository uses Git submodules. If these submodule references are to other VA repositories, you will want to migrate the repositories used as submodules first and then update the submodule references after migration to point to the new migrated repositories. |
| AE | repository-discussions | The number of discussions that have been created on this repository. These will not be migrated. |
| AF | repository-deploy-keys | The number of deploy keys on this repository. These will not be migrated. |
| AG | repository-pages-customdomain | If this repository has a custom domain specified for GitHub Pages. The Pages settings will be migrated, but not the custom domain (CNAME) configuration. |
| AH | repository-pinned-issues | The number of pinned issues on this repository. The issue will be migrated, but it will not remain pinned. |
| AI | has_unmigratable | If the tool has identified at least one item (other columns in the spreadsheet) that will not be migrated by GEI. |