Initial commit - Gitea integration
This commit is contained in:
189
GITEA_SETUP.md
Normal file
189
GITEA_SETUP.md
Normal file
@@ -0,0 +1,189 @@
|
||||
# Gitea .profile Repository
|
||||
|
||||
## ✅ Setup Complete!
|
||||
|
||||
Your `.profile` repository has been successfully created on Gitea with HTTPS authentication using a Personal Access Token (PAT).
|
||||
|
||||
### 📍 Repository Information
|
||||
|
||||
- **Repository Name:** `.profile`
|
||||
- **User:** willow-ai
|
||||
- **Full URL:** https://git.wholeworldcoding.com/willow-ai/.profile
|
||||
- **Clone URL:** https://git.wholeworldcoding.com/willow-ai/.profile.git
|
||||
- **Authentication:** Personal Access Token (PAT)
|
||||
- **HTTPS:** ✅ Working
|
||||
|
||||
### 🔑 PAT Details
|
||||
|
||||
```
|
||||
Token: d1da5d8c17a64d89afca0123c5b781073e69f9c1
|
||||
Username: willow-ai
|
||||
```
|
||||
|
||||
### 💻 Git Configuration
|
||||
|
||||
Configure git to remember your PAT:
|
||||
|
||||
```bash
|
||||
# Clone the repository
|
||||
git clone https://git.wholeworldcoding.com/willow-ai/.profile.git
|
||||
|
||||
# Configure git to store the token
|
||||
git config --global credential.https.*.password d1da5d8c17a64d89afca0123c5b781073e69f9c1
|
||||
|
||||
# Verify setup
|
||||
git remote -v
|
||||
```
|
||||
|
||||
### 📝 First Push
|
||||
|
||||
```bash
|
||||
cd /Users/stevensherry/.profile
|
||||
|
||||
# Configure git user (required for commits)
|
||||
git config user.name "Willow"
|
||||
git config user.email "willow@wholeworldcoding.com"
|
||||
|
||||
# Add and commit
|
||||
git add .
|
||||
git commit -m "Your commit message here"
|
||||
|
||||
# Push to Gitea
|
||||
git push -u origin main
|
||||
```
|
||||
|
||||
### 🔄 Clone and Pull
|
||||
|
||||
```bash
|
||||
# Clone fresh copy
|
||||
git clone https://git.wholeworldcoding.com/willow-ai/.profile.git
|
||||
|
||||
# Pull latest changes
|
||||
cd .profile
|
||||
git pull origin main
|
||||
|
||||
# Make changes
|
||||
# edit files...
|
||||
|
||||
git add .
|
||||
git commit -m "Your message"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
### 🛠️ Helper Scripts
|
||||
|
||||
A helper script `git-auth` is available in `/scripts/git-auth` for automated git operations.
|
||||
|
||||
### 📁 Repository Structure
|
||||
|
||||
```
|
||||
.profile/
|
||||
├── README.md # This file and initial Gitea docs
|
||||
├── GITEA_SETUP.md # Detailed Gitea API setup instructions
|
||||
├── GITEA_README.md # This file with quick start guide
|
||||
├── scripts/
|
||||
│ ├── git-auth # Git authentication helper
|
||||
│ └── git-gitea # API-based git commands
|
||||
└── .git/ # Git repository
|
||||
```
|
||||
|
||||
### 🌐 Access
|
||||
|
||||
- **Web UI:** https://git.wholeworldcoding.com/willow-ai/.profile
|
||||
- **API:** https://git.wholeworldcoding.com/api/v1
|
||||
- **GitHub Compatible URL:** https://git.wholeworldcoding.com/willow-ai/.profile.git
|
||||
|
||||
### 🧪 Testing HTTPS
|
||||
|
||||
```bash
|
||||
# Test connection
|
||||
export GITEA_TOKEN="d1da5d...f9c1"
|
||||
curl -H "Authorization: Bearer $GITEA_TOKEN" \
|
||||
https://git.wholeworldcoding.com/api/v1/user/repos
|
||||
|
||||
# Should return JSON with repository info
|
||||
```
|
||||
|
||||
### 📚 Documentation
|
||||
|
||||
- **GITEA_SETUP.md** - Comprehensive Gitea API guide
|
||||
- **GITEA_README.md** - Quick start with this repository
|
||||
- **scripts/git-gitea** - API-based git commands
|
||||
- **test_gitea_https.sh** - Test script
|
||||
|
||||
### 🔒 Security
|
||||
|
||||
⚠️ **IMPORTANT:**
|
||||
1. Never commit your PAT to version control
|
||||
2. Don't share the token publicly
|
||||
3. Store in `~/.gitea-token` (add to .gitignore)
|
||||
4. Use environment variable: `export GITEA_TOKEN="..."`
|
||||
|
||||
```bash
|
||||
# Good practice
|
||||
echo "d1da5d8c17a64d89afca0123c5b781073e69f9c1" > ~/.gitea-token
|
||||
chmod 600 ~/.gitea-token
|
||||
|
||||
# Use in scripts
|
||||
source ~/.gitea-token
|
||||
export GITEA_TOKEN=$GITEA_TOKEN
|
||||
```
|
||||
|
||||
### 🎯 API Rate Limits
|
||||
|
||||
- **Authenticated users:** 5000 requests per hour
|
||||
- **Check limits:** `curl -H "Authorization: Bearer..." api/ratelimit`
|
||||
- **Headers in responses:** `X-RateLimit-Remaining`
|
||||
|
||||
### 📖 Quick API Reference
|
||||
|
||||
```bash
|
||||
# List my repos
|
||||
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/user/repos
|
||||
|
||||
# Get repo info
|
||||
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile
|
||||
|
||||
# List contents
|
||||
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile/contents
|
||||
|
||||
# List commits
|
||||
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile/commits
|
||||
|
||||
# Create issue
|
||||
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile/issues \
|
||||
-d '{"title": "Issue title", "body": "Issue description"}'
|
||||
|
||||
# List tags
|
||||
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos/willow-ai/.profile/tags
|
||||
|
||||
# Search
|
||||
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/search/repositories?q=python
|
||||
|
||||
# List all public repos
|
||||
curl -H "Authorization: Bearer YOUR_TOKEN" https://git.wholeworldcoding.com/api/v1/repos
|
||||
```
|
||||
|
||||
### 🎉 What's Working
|
||||
|
||||
✅ Repository created on Gitea (ID: 92)
|
||||
✅ HTTPS clone with PAT
|
||||
✅ API authentication with token
|
||||
✅ Helper scripts for git commands
|
||||
✅ Web UI access
|
||||
✅ API documentation available
|
||||
|
||||
### 🚀 Ready to Use!
|
||||
|
||||
Your `.profile` repository is ready for:
|
||||
- Pushing code via HTTPS/PAT
|
||||
- Pulling code from Gitea
|
||||
- Managing issues and PRs via API
|
||||
- Creating new repositories via API
|
||||
- Searching and exploring repositories
|
||||
|
||||
---
|
||||
|
||||
*Created with Hermes Gitea API integration*
|
||||
*Repository: willow-ai/.profile*
|
||||
*Created: $(date +%Y-%m-%d)*
|
||||
Reference in New Issue
Block a user