github-migration/.env.example at main · pythoninthegrasses/github-migration · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
# GitHub Account and Organization Migration Configuration
# Copy this file to .env and configure your values

# ============================================================================
# SOURCE AND TARGET
# ============================================================================

# Source GitHub username (personal account before rename)
SOURCE_OWNER=pythoninthegrass

# Target organization name (destination for repos)
TARGET_ORG=pythoninthegrass2

# ============================================================================
# TRANSFER SETTINGS (01_transfer_repos.py)
# ============================================================================

# Dry run mode - set to false to perform actual transfers
DRY_RUN=true

# Number of repos to transfer in each batch
BATCH_SIZE=5

# Delay in seconds between individual transfers (rate limiting)
DELAY_BETWEEN_TRANSFERS=2

# Delay in seconds between batches (rate limiting)
DELAY_BETWEEN_BATCHES=10

# Exclude forked repositories from transfer (true/false)
EXCLUDE_FORKS=false

# Exclude archived repositories from transfer (true/false)
EXCLUDE_ARCHIVED=false

# Pilot mode - transfer only specific repos for testing
PILOT_MODE=false

# Comma-separated list of repo names for pilot testing
# Example: PILOT_REPOS=repo1,repo2,repo3
PILOT_REPOS=

# ============================================================================
# RETRY SETTINGS (05_retry_failed_transfers.py)
# ============================================================================

# Maximum retry attempts for failed transfers
MAX_RETRIES=3

# Initial delay in seconds before first retry (doubles each attempt)
INITIAL_DELAY=5

# ============================================================================
# LOCAL CLEANUP SETTINGS (04_cleanup_local_clones.py)
# ============================================================================

# Directory to search for local git repositories
SEARCH_DIR=/Users/lance/git

# Old owner name (after personal account rename)
OLD_OWNER=pythoninthegrass_og

# New owner name (organization after rename)
NEW_OWNER=pythoninthegrass

# ============================================================================
# NOTES
# ============================================================================
#
# Execution Order:
# 1. Day 1: 00_pre_migration_audit.py (DRY_RUN not applicable)
# 2. Day 2: 01_transfer_repos.py (with DRY_RUN=true first)
# 3. Day 2: 01_transfer_repos.py (with DRY_RUN=false, PILOT_MODE=true)
# 4. Day 3-4: 01_transfer_repos.py (full migration, DRY_RUN=false)
# 5. Day 5: Manual rename operations (via GitHub web UI)
# 6. Day 6: 03_post_migration_validation.py
# 7. Day 6: 04_cleanup_local_clones.py (with DRY_RUN=true first)
#
# GitHub CLI Authentication:
# - Ensure 'gh auth status' shows you're logged in as SOURCE_OWNER
# - The scripts use 'gh' CLI for all GitHub API operations
#
# Rate Limits:
# - Personal accounts: 5,000 requests/hour
# - With authentication: Higher limits apply
# - The scripts include delays to avoid hitting rate limits
#
# Transfer Limitations:
# - Cannot transfer repos you don't own
# - Cannot transfer repos with pending transfers (wait 24h)
# - Cannot transfer repos larger than 100GB (rare)
#