gitea

Ta rola konfiguruje serwer Gitea za pomocą obrazu dockera.

Rola ta jedynie zajmuje się ustawieniem usługi, a jej konfiguracja odbywa się za pośrednictwem interfejsu internetowego przy pierwszym uruchomieniu usługi.

Wymagania

Ta rola wymaga, aby docker był dostępny na hoście oraz aby był używany moduł docker_container w ansible.

Aby spełnić pierwszy warunek, można użyć roli geerlingguy.docker.

Aby pokryć zależności dla modułu docker_container, można użyć roli geerlingguy.pip, aby zainstalować pakiet Pythona docker.

Podobnie jak w przypadku każdego serwera git, zaleca się korzystanie z SSH do dostępu do repozytoriów, dlatego należy przekierować port do portu SSH kontenera. Nie musi to być standardowy port SSH.

Gitea zapewnia również interfejs internetowy, więc konieczne jest zapewnienie dostępu do niego. Zaleca się użycie reverse proxy, takiego jak nginx, w tym celu.

Zmienne roli

• gitea__version (opcjonalnie, domyślnie: 1.22.0): Tag wersji obrazu do użycia.
• gitea__container_name (opcjonalnie, domyślnie: gitea-server): Nazwa do używania dla kontenera utworzonego przez rolę.
• gitea__data_dir (opcjonalnie, domyślnie /var/gitea/): Folder do przechowywania plików trwałych.
• gitea__ssh_port (opcjonalnie, domyślnie: 2222): Port, na którym kontener opublikuje port SSH gitea.
• gitea__web_host (opcjonalnie, domyślnie: 127.0.0.1): Adres, pod którym kontener opublikuje gitea's web socket.
• gitea__web_port (opcjonalnie, domyślnie: 3000): Port, na którym kontener opublikuje port web gitea.
• gitea__hostname (opcjonalnie, domyślnie: localhost): Nazwa domeny do użycia dla wyświetlanego URL do klonowania http w UI.
• gitea__root_url (opcjonalnie, domyślnie: http://localhost:3000/): Podstawowy URL do użycia dla wszystkich linków wewnętrznych. Użyj rzeczywistego URL, który będzie używany do dostępu do usługi. Na przykład https://git.example.com/
• gitea__enable_lfs (opcjonalnie, domyślnie: no): Włączyć wsparcie dla git-lfs.
• gitea__app_name (opcjonalnie): Nazwa aplikacji, używana w tytule strony.

Przykładowy playbook

Poniżej znajduje się przykładowe użycie roli:

- host: git.my-domain.com
  roles:
    - role: salessandri.gitea
    - vars:
        gitea__hostname: git.my-domain.com
        gitea__root_url: https://git.my-domain.com/

Licencja

MIT

Informacje o autorze

Ta rola została stworzona w 2020 roku przez Santiago Alessandri.