test: CI/CD pipeline staging test - Repository Setup automatisiert

deployment/stacks/gitea/README.md

@@ -86,6 +86,39 @@ docker compose ps
 
 ### First Time Configuration
 
+**Option 1: Automated Setup (Recommended)**
+
+The Gitea initial setup can be automated using Ansible:
+
+```bash
+cd deployment/ansible
+
+# 1. Set Gitea admin credentials in vault
+ansible-vault edit secrets/production.vault.yml --vault-password-file secrets/.vault_pass
+
+# Add these variables:
+# vault_gitea_admin_username: "admin"
+# vault_gitea_admin_password: "your-secure-password"
+# vault_gitea_admin_email: "kontakt@michaelschiemer.de"
+
+# 2. Run the setup playbook
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-gitea-initial-config.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+The playbook will:
+- Check if Gitea is already configured
+- Generate `app.ini` with `INSTALL_LOCK = true` to skip the initial setup page
+- Copy the configuration file to the Gitea container
+- Create admin user via Gitea CLI with credentials from vault
+- Use database settings from environment variables
+
+**How it works:**
+The playbook creates a complete `app.ini` configuration file with `INSTALL_LOCK = true` in the `[security]` section. This tells Gitea to skip the initial setup wizard. The admin user is then created using the `gitea admin user create` command.
+
+**Option 2: Manual Setup**
+
 1. **Access Gitea**: https://git.michaelschiemer.de
 
 2. **Initial Setup Wizard**:
@@ -107,6 +140,28 @@ docker compose ps
 
 ### Creating a Repository
 
+**Option 1: Automated Setup (Recommended)**
+
+Use Ansible to automatically create the repository and configure Git remote:
+
+```bash
+cd deployment/ansible
+
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-gitea-repository.yml \
+  --vault-password-file secrets/.vault_pass \
+  -e "repo_name=michaelschiemer" \
+  -e "repo_owner=michael" \
+  -e "repo_private=false"
+```
+
+The playbook will:
+- Create repository in Gitea via API
+- Configure Git remote automatically
+- Use credentials from Ansible Vault
+
+**Option 2: Manual Setup**
+
 1. Log in to https://git.michaelschiemer.de
 2. Click "+" → "New Repository"
 3. Fill in repository details