Gitea Doku

_toc.yml

@@ -167,6 +167,7 @@ chapters:
           - file: engineering-guide/lxsup
           - file: engineering-guide/lxweb00
           - file: engineering-guide/gitea
+          - file: engineering-guide/gitea-dmz
       - file: engineering-guide/infrastructure_administration
       - file: engineering-guide/troubleshooting
       - file: engineering-guide/accounts-and-groups
@@ -205,6 +206,12 @@ chapters:
               - file: services/user-guide/gitlab/gitpages.psi.ch
               - file: services/user-guide/gitlab/dependency_proxy
               - file: services/user-guide/gitlab/gitlab_cli
+          - file: services/user-guide/gitea/gitea
+            sections:
+              - file: services/user-guide/gitea/gitea-faq
+              - file: services/user-guide/gitea/gitea-pages
+              - file: services/user-guide/gitea/gitea-runner
+              - file: services/user-guide/gitea/gitea-snippets
       - file: services/admin-guide/index
         sections:
           - file: services/admin-guide/unix_groups

engineering-guide/gitea-dmz.md

@@ -0,0 +1,2 @@
+# Gitea Production Documentation
+![Gitea](gitea/gitea_setup.png)

services/user-guide/gitea/gitea-faq.md

@@ -0,0 +1,68 @@
+# Important information about the Gitea migration
+Most frequently asked questions about the Gitea migration and guides to get started.
+If you are missing something here please contact [Gitea Project](mailto:gitea@psi.ch)
+
+## What Serives are available?
+### GIT
+Gitea is a barebone GIT service. It is a GitHub fork and therefore very similar to GitHub.
+https://gitea.psi.ch
+
+### Pages
+You can publish your own gitpage within seconds!
+There is two ways described here how you can create your own gitpage:
+1. Create a Repository called gitea-pages in your Organization with a second branch called gitea-pages.
+All content inside the gitea-pages branch will be automatically published under: {YourOrg}.pages.psi.ch
+If you want to have this content available in the internet, please open a SNOW ticket with your request and some justyfication about why that should be exposed to the internet.
+
+2. Create a gitea-pages branch inside any repository, the content of that branch will be served at: {YourOrg}.pages.psi.ch/{YourRepo}
+Same rules for publishing apply to this method too.
+
+### Snippets
+Since Gitea has no way to publish snippets we introduce snippets.psi.ch
+When you press "Continue with PSI Gitea account" the Auth token used with Gitea will be reused to login to snippets. (Also works if you have MFA enabled)
+Snippets can be read by anonymous users / services but only created by a logged in user.
+
+### Runners
+We provide runners in every security zone, that you can wherever you are inside PSI-Network use the CI/CD from Gitea.
+If none of the runners available to your project suits you, you can contact [Gitea Project](mailto:gitea@psi.ch) and we can find a solution that fits you best.
+The runner RPM is available on repos.psi.ch and also as package to download in the Linux Organization on Gitea. https://gitea.psi.ch/linux/act-runner/packages
+
+
+## FAQ
+
+### My Project was migrated and I can't push anymore
+This Project was archived and is now available on https://gitea.psi.ch
+Please use following commands to update your local git:
+
+- `git remote -v`
+- If the output starts with "origin https..." use option 1 otherwise 2
+1. `git remote set-url https://gitea.psi.ch/{Org}/{Repo}.git`
+2. `git remote set-url git@gitea.psi.ch:/{Org}/{Repo}.git`
+If you have not recieved a special notification about the archival the organization is the Gitlab group name.
+
+More information about archived projects can be found here:
+- https://docs.gitlab.com/user/project/working_with_projects/#archive-a-project
+
+### I want to migrate a project from Gitlab / Github to Gitea
+Login to https://gitea.psi.ch with your PSI LDAP account. (Username: muster_m Password: SUPERSECRET123)
+Since Gitea is a GitHub fork, you will find Organizations instead of groups. Every user is allowed to create Organizations.
+When should I create a new Organization? -> If you are (or feel) responsible for a certain team in PSI it makes sense to create an Organization named likewise. Try to use the official names used at PSI. In the top left corner you can click on browse and then Organizations to see if someone already created the desired organization. 
+
+Optional:
+- Click the "+" in the top right of your screen and create an organization
+- Authorization inside Organizations can be done via Teams - Create Team and give the persmissions you need
+- If you want to use AD Groups to authorize people in your Teams please contact [Gitea Project](mailto:gitea@psi.ch)
+
+Migration:
+- Click the "+" in the top right of your screen and click "New Migration"
+- Choose the Source you want to migrate from
+- Enter the HTTPS clone URL
+- On the source you need to create an access token for that project
+- Paste the token in "Access Token"
+- Choose the migration options (Attention! If you choose mirror, you won't be able to migrate releases!)
+- Choose an Owner (Organization or if its a personal Project your Username) and give it a name. (Can be the existing one)
+
+### I had a collaboration with non PSI Users on gitlab.psi.ch
+All "ext-" users have been imported as restricted users and must be explicitly added to a project.
+If you are missing a user and you are sure it has a PSI account, message [Gitea Project](mailto:gitea@psi.ch)
+

services/user-guide/gitea/gitea-pages.md

@@ -0,0 +1,2 @@
+# Gitea Pages
+Available under {YourOrg}.pages.psi.ch

services/user-guide/gitea/gitea-runner.md

@@ -0,0 +1,2 @@
+# Gitea Runner
+Available in every security zone

services/user-guide/gitea/gitea-snippets.md

@@ -0,0 +1,2 @@
+# Gitea Snippets
+Snippet Server for Gitea has SSO with gitea.psi.ch

services/user-guide/gitea/gitea.md

@@ -0,0 +1,5 @@
+# Gitea (Git with a cup of tea) 
+This is the official GIT Service at PSI.
+It offers a wide range of features and improvements to the Gitlab service and will be its successor.
+Here you can find various information about the services offered with Gitea and a FAQ about the migration.
+