Post-Radicle sync at 2025-06-05 01:07:56
This commit is contained in:
Mark Randall Havens
parent
d4edf2afd8
commit
bf03d19403
29 changed files with 351 additions and 1 deletions
55
docs/github/1_prerequisites_github_ubuntu.md
Normal file
55
docs/github/1_prerequisites_github_ubuntu.md
Normal file
|
|
@ -0,0 +1,55 @@
|
|||
## 📘 `1_prerequisites_github_ubuntu.md`
|
||||
|
||||
### 📌 Purpose
|
||||
|
||||
Prepare your Ubuntu system to create and work with remote GitHub repositories using SSH.
|
||||
|
||||
---
|
||||
|
||||
### ✅ System Requirements
|
||||
|
||||
* **Install Git**
|
||||
|
||||
```bash
|
||||
sudo apt update
|
||||
sudo apt install git -y
|
||||
```
|
||||
|
||||
* **Create a GitHub account**
|
||||
👉 [https://github.com/join](https://github.com/join)
|
||||
|
||||
* **Set your Git identity**
|
||||
|
||||
```bash
|
||||
git config --global user.name "Your Name"
|
||||
git config --global user.email "your_email@example.com"
|
||||
```
|
||||
|
||||
* **Generate an SSH key (if not already present)**
|
||||
|
||||
```bash
|
||||
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
|
||||
eval "$(ssh-agent -s)"
|
||||
ssh-add ~/.ssh/id_rsa
|
||||
```
|
||||
|
||||
* **Add your SSH public key to GitHub**
|
||||
|
||||
```bash
|
||||
cat ~/.ssh/id_rsa.pub
|
||||
```
|
||||
|
||||
🔗 Copy the output and paste it at:
|
||||
GitHub → Settings → SSH and GPG keys → *New SSH key*
|
||||
|
||||
* **Test the connection**
|
||||
|
||||
```bash
|
||||
ssh -T git@github.com
|
||||
```
|
||||
|
||||
You should see:
|
||||
|
||||
> "Hi `your-username`! You've successfully authenticated..."
|
||||
|
||||
---
|
||||
73
docs/github/2_create_remote_repo_github_ubuntu.md
Normal file
73
docs/github/2_create_remote_repo_github_ubuntu.md
Normal file
|
|
@ -0,0 +1,73 @@
|
|||
## 📘 `2_create_remote_repo_github_ubuntu.md`
|
||||
|
||||
### 📌 Purpose
|
||||
|
||||
Create a new remote repository on GitHub and push your local Ubuntu-based Git project to it.
|
||||
|
||||
---
|
||||
|
||||
### 🪐 Step-by-Step
|
||||
|
||||
#### Step 1: Create the remote repository
|
||||
|
||||
1. Go to [https://github.com/new](https://github.com/new)
|
||||
2. Set:
|
||||
|
||||
* Repository Name
|
||||
* Visibility (Public or Private)
|
||||
* ✅ Leave **"Initialize with README"** unchecked
|
||||
3. Click **Create repository**
|
||||
|
||||
---
|
||||
|
||||
#### Step 2: Prepare your local repository
|
||||
|
||||
If starting fresh:
|
||||
|
||||
```bash
|
||||
mkdir myproject
|
||||
cd myproject
|
||||
git init
|
||||
```
|
||||
|
||||
If converting an existing project:
|
||||
|
||||
```bash
|
||||
cd myproject
|
||||
git init
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### Step 3: Add files and commit
|
||||
|
||||
```bash
|
||||
touch README.md # or edit existing files
|
||||
git add .
|
||||
git commit -m "Initial commit"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### Step 4: Link to GitHub remote
|
||||
|
||||
```bash
|
||||
git remote add origin git@github.com:your-username/your-repo-name.git
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### Step 5: Push to GitHub
|
||||
|
||||
```bash
|
||||
git push -u origin main
|
||||
```
|
||||
|
||||
> If you get an error about `main` not existing:
|
||||
|
||||
```bash
|
||||
git branch -M main
|
||||
git push -u origin main
|
||||
```
|
||||
|
||||
---
|
||||
51
docs/github/3_commit_existing_repo_github_ubuntu.md
Normal file
51
docs/github/3_commit_existing_repo_github_ubuntu.md
Normal file
|
|
@ -0,0 +1,51 @@
|
|||
## 📘 `3_commit_existing_repo_github_ubuntu.md`
|
||||
|
||||
### 📌 Purpose
|
||||
|
||||
Work with an existing remote GitHub repository on Ubuntu. This includes cloning, committing changes, and pushing updates.
|
||||
|
||||
---
|
||||
|
||||
### 🛠️ Step-by-Step
|
||||
|
||||
#### Step 1: Clone the repository
|
||||
|
||||
```bash
|
||||
git clone git@github.com:your-username/your-repo-name.git
|
||||
cd your-repo-name
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### Step 2: Make your changes
|
||||
|
||||
```bash
|
||||
nano example.txt
|
||||
```
|
||||
|
||||
Or update files as needed.
|
||||
|
||||
---
|
||||
|
||||
#### Step 3: Stage and commit your changes
|
||||
|
||||
```bash
|
||||
git add .
|
||||
git commit -m "Describe your update"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### Step 4: Push to GitHub
|
||||
|
||||
```bash
|
||||
git push origin main
|
||||
```
|
||||
|
||||
> Use the correct branch name if not `main`. Confirm with:
|
||||
|
||||
```bash
|
||||
git branch
|
||||
```
|
||||
|
||||
---
|
||||
97
docs/github/CLI-ONLY_workflow_github_ubuntu.md
Normal file
97
docs/github/CLI-ONLY_workflow_github_ubuntu.md
Normal file
|
|
@ -0,0 +1,97 @@
|
|||
---
|
||||
|
||||
## 🧭 FULL CLI-ONLY WORKFLOW (Ubuntu + GitHub)
|
||||
|
||||
---
|
||||
|
||||
### 🔹 Step 1 — Install prerequisites
|
||||
|
||||
```bash
|
||||
# Install Git
|
||||
sudo apt update
|
||||
sudo apt install git -y
|
||||
|
||||
# Install GitHub CLI
|
||||
type -p curl >/dev/null || sudo apt install curl -y
|
||||
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | \
|
||||
sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
|
||||
sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg
|
||||
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] \
|
||||
https://cli.github.com/packages stable main" | \
|
||||
sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
|
||||
sudo apt update
|
||||
sudo apt install gh -y
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 🔹 Step 2 — Authenticate with GitHub
|
||||
|
||||
```bash
|
||||
gh auth login
|
||||
```
|
||||
|
||||
* Choose: `GitHub.com`
|
||||
* Protocol: `SSH`
|
||||
* Authenticate via browser (first time only—after that you're CLI-auth’d)
|
||||
|
||||
---
|
||||
|
||||
### 🔹 Step 3 — Set global Git identity
|
||||
|
||||
```bash
|
||||
git config --global user.name "Your Name"
|
||||
git config --global user.email "your_email@example.com"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 🔹 Step 4 — Create and link a new GitHub repo (CLI-only)
|
||||
|
||||
From inside your project directory:
|
||||
|
||||
```bash
|
||||
mkdir myproject
|
||||
cd myproject
|
||||
git init
|
||||
echo "# My Project" > README.md
|
||||
git add .
|
||||
git commit -m "Initial commit"
|
||||
```
|
||||
|
||||
Now create a GitHub repo **from the CLI**:
|
||||
|
||||
```bash
|
||||
gh repo create myproject --public --source=. --remote=origin --push
|
||||
```
|
||||
|
||||
✅ This:
|
||||
|
||||
* Creates the remote GitHub repo
|
||||
* Links it to your local repo
|
||||
* Pushes your first commit to GitHub
|
||||
|
||||
---
|
||||
|
||||
### 🔹 Step 5 — Make further commits
|
||||
|
||||
```bash
|
||||
# Edit files as needed
|
||||
nano something.txt
|
||||
|
||||
# Stage + commit + push
|
||||
git add .
|
||||
git commit -m "Updated something"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 🔹 Bonus — Clone a GitHub repo entirely from CLI
|
||||
|
||||
```bash
|
||||
gh repo clone your-username/your-repo
|
||||
cd your-repo
|
||||
```
|
||||
|
||||
---
|
||||
123
docs/github/gitfield-github-old
Executable file
123
docs/github/gitfield-github-old
Executable file
|
|
@ -0,0 +1,123 @@
|
|||
#!/bin/bash
|
||||
|
||||
set -euo pipefail
|
||||
IFS=$'\n\t'
|
||||
|
||||
GIT_REMOTE_NAME="github"
|
||||
REPO_NAME=$(basename "$(pwd)")
|
||||
DEFAULT_NAME="Mark Randall Havens"
|
||||
DEFAULT_EMAIL="mark.r.havens@gmail.com"
|
||||
|
||||
# ────────────────
|
||||
# Logging Helpers
|
||||
# ────────────────
|
||||
info() { echo -e "\e[1;34m[INFO]\e[0m $*"; }
|
||||
warn() { echo -e "\e[1;33m[WARN]\e[0m $*"; }
|
||||
error() { echo -e "\e[1;31m[ERROR]\e[0m $*" >&2; exit 1; }
|
||||
|
||||
# ────────────────
|
||||
# Ensure Git is Installed
|
||||
# ────────────────
|
||||
if ! command -v git &>/dev/null; then
|
||||
info "Installing Git..."
|
||||
sudo apt update && sudo apt install git -y || error "Failed to install Git"
|
||||
else
|
||||
info "Git already installed: $(git --version)"
|
||||
fi
|
||||
|
||||
# ────────────────
|
||||
# Ensure GitHub CLI is Installed
|
||||
# ────────────────
|
||||
if ! command -v gh &>/dev/null; then
|
||||
info "Installing GitHub CLI..."
|
||||
type -p curl >/dev/null || sudo apt install curl -y
|
||||
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | \
|
||||
sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
|
||||
sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg
|
||||
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] \
|
||||
https://cli.github.com/packages stable main" | \
|
||||
sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
|
||||
sudo apt update && sudo apt install gh -y || error "Failed to install GitHub CLI"
|
||||
else
|
||||
info "GitHub CLI already installed: $(gh --version | head -n 1)"
|
||||
fi
|
||||
|
||||
# ────────────────
|
||||
# Ensure GitHub CLI is Authenticated
|
||||
# ────────────────
|
||||
if ! gh auth status &>/dev/null; then
|
||||
info "Authenticating GitHub CLI..."
|
||||
gh auth login || error "GitHub authentication failed"
|
||||
else
|
||||
info "GitHub CLI authenticated."
|
||||
fi
|
||||
|
||||
# ────────────────
|
||||
# Ensure Git Identity is Set
|
||||
# ────────────────
|
||||
USER_NAME=$(git config --global user.name || true)
|
||||
USER_EMAIL=$(git config --global user.email || true)
|
||||
|
||||
if [[ -z "$USER_NAME" || -z "$USER_EMAIL" ]]; then
|
||||
info "Setting global Git identity..."
|
||||
git config --global user.name "$DEFAULT_NAME"
|
||||
git config --global user.email "$DEFAULT_EMAIL"
|
||||
info "Git identity set to: $DEFAULT_NAME <$DEFAULT_EMAIL>"
|
||||
else
|
||||
info "Git identity already set to: $USER_NAME <$USER_EMAIL>"
|
||||
fi
|
||||
|
||||
# ────────────────
|
||||
# Initialize Git Repo If Missing
|
||||
# ────────────────
|
||||
if [ ! -d ".git" ]; then
|
||||
info "Initializing local Git repository..."
|
||||
git init || error "Failed to initialize git"
|
||||
git add . || warn "Nothing to add"
|
||||
git commit -m "Initial commit" || warn "Nothing to commit"
|
||||
else
|
||||
info "Git repository already initialized."
|
||||
fi
|
||||
|
||||
# ────────────────
|
||||
# Ensure at Least One Commit Exists
|
||||
# ────────────────
|
||||
if ! git rev-parse HEAD &>/dev/null; then
|
||||
info "Creating first commit..."
|
||||
git add . || warn "Nothing to add"
|
||||
git commit -m "Initial commit" || warn "Nothing to commit"
|
||||
fi
|
||||
|
||||
# ────────────────
|
||||
# Create Remote GitHub Repo If Missing
|
||||
# ────────────────
|
||||
if ! git remote get-url "$GIT_REMOTE_NAME" &>/dev/null; then
|
||||
info "Creating GitHub repository '$REPO_NAME'..."
|
||||
gh repo create "$REPO_NAME" --public --source=. --remote="$GIT_REMOTE_NAME" || error "Failed to create GitHub repo"
|
||||
else
|
||||
info "Remote '$GIT_REMOTE_NAME' already set to: $(git remote get-url $GIT_REMOTE_NAME)"
|
||||
fi
|
||||
|
||||
# ────────────────
|
||||
# Commit Changes If Needed
|
||||
# ────────────────
|
||||
if ! git diff --quiet || ! git diff --cached --quiet; then
|
||||
info "Changes detected — committing..."
|
||||
git add .
|
||||
git commit -m "Update: $(date '+%Y-%m-%d %H:%M:%S')" || warn "Nothing to commit"
|
||||
else
|
||||
info "No uncommitted changes found."
|
||||
fi
|
||||
|
||||
# ────────────────
|
||||
# Final Push — Always Push, Even If No Upstream
|
||||
# ────────────────
|
||||
BRANCH_NAME=$(git rev-parse --abbrev-ref HEAD)
|
||||
|
||||
if ! git config --get branch."$BRANCH_NAME".remote &>/dev/null; then
|
||||
info "No upstream detected. Setting upstream and pushing..."
|
||||
git push -u "$GIT_REMOTE_NAME" "$BRANCH_NAME" || error "Failed to push and set upstream"
|
||||
else
|
||||
info "Pushing to remote '$GIT_REMOTE_NAME'..."
|
||||
git push "$GIT_REMOTE_NAME" "$BRANCH_NAME" || error "Push failed"
|
||||
fi
|
||||
Loading…
Add table
Add a link
Reference in a new issue