Cómo instalar GitBucket en Ubuntu 16.04

• Prerrequisitos
• Instalar requisitos previos
• Instalando GitBucket
• Configurar el proxy inverso de Nginx

Esta guía cubre la instalación básica y la configuración de GitBucket para una instancia de Vultr que ejecuta Ubuntu 16.04, y asume que está ejecutando comandos como non-rootusuario.

Prerrequisitos

• Una instancia de servidor Vultr con al menos 1 GB de RAM (las instancias más pequeñas pueden funcionar, aunque lentamente).
• openjdk-8-jre Obligatorio, las versiones anteriores no funcionarán.
• wget Se usa para descargar el paquete GitBucket.
• nginx Opcional, proporciona un proxy inverso a GitBucket
• systemd Administra el inicio y la detención del proceso de GitBucket

Instalar requisitos previos

GitBucket requiere que Java 8 o más reciente esté instalado en su servidor. Si aún no ha instalado Java 8, primero actualice sus listas de paquetes locales.

sudo apt update

Luego instale el paquete de tiempo de ejecución Java 8.

sudo apt install openjdk-8-jre

Instalando GitBucket

Crear un usuario sin privilegios

Tendremos que crear un usuario sin privilegios para ejecutar GitBucket antes de continuar. Ejecutar GitBucket bajo un usuario no privilegiado restringe nuestra instalación de escribir fuera de su propio directorio de datos, fortaleciendo la seguridad de su servidor. Ejecute el siguiente comando para crear un usuario del sistema llamado gitbucket.

sudo adduser --system gitbucket

Debido a que creamos un usuario del sistema , el shell predeterminado es /bin/false, y volveremos a nuestro shell actual a menos que proporcionemos un argumento de shell adicional cuando se ejecute su. Inicie sesión en el usuario recién creado.

sudo su - gitbucket -s /bin/bash

La solicitud de su shell debería cambiar, y usted iniciará sesión en el nuevo usuario del sistema.

Descargando / Actualizando GitBucket

Vaya a la página de versiones de GitBucket y busque la última versión disponible. Copie la URL del gitbucket.warpaquete, verifique que se encuentra en el directorio de inicio del nuevo usuario y descárguelo con wget.

cd ~/
wget https://github.com/gitbucket/gitbucket/releases/download/4.18.0/gitbucket.war

Deberá repetir este paso cada vez que desee actualizar el paquete GitBucket.

Configuración inicial de GitBucket

Una vez que se haya descargado el paquete, necesitaremos iniciar GitBucket manualmente para realizar alguna configuración inicial.

java -jar gitbucket.war --port 8080

Si el puerto 8080ya está ocupado por otro proceso, puede cambiar el puerto que GitBucket escuchará ahora. Esta guía supone que GitBucket está escuchando en el puerto8080 .

Esto iniciará GitBucket en la interfaz de red pública de su servidor, escuchando en el puerto especificado. Debería ver, después de unos momentos, el siguiente mensaje.

INFO:oejs.Server:main: Started @15891ms

Si está utilizando el firewall de Vultr , deberá abrir el puerto que GitBucket está escuchando, ya que el firewall de Vultr funciona como una lista blanca, rechazando el tráfico para permitir puertos a menos que se especifique lo contrario.

Su instalación de GitBucket ahora debería estar en línea y accesible desde internet. Con un navegador web, conéctese a la dirección pública de su servidor (asegúrese de especificar el puerto en el que se ejecuta GitBucket, (es decir, http://203.0.113.0:8080o http://example.com:8080), y aterrizará en la página de inicio de GitBucket.

Sin embargo, la contraseña de la cuenta de administrador predeterminada debe cambiarse. Para hacerlo, inicie sesión en la cuenta de administrador a través del Sign inbotón en la esquina superior derecha de la interfaz web. El inicio de sesión predeterminado para la cuenta de administrador es rootpara el nombre de usuario y luego rootnuevamente para la contraseña. Una vez que haya iniciado sesión, el botón será reemplazado por un ícono de perfil y desplegable. Expanda el menú desplegable y seleccione Account Settings, luego configure una contraseña nueva y más segura en el asistente de configuración de la cuenta.

Después de actualizar las credenciales de la cuenta de administrador predeterminada y verificar que GitBucket se inicia en esta configuración mínima, elimine el proceso Java con " CTRL+C" y cierre el shell actual con exit.

Crear el servicio Systemd

Actualmente, solo podemos ejecutar GitBucket accediendo a nuestro servidor a través de SSH e iniciando el proceso desde un shell manualmente. Afortunadamente, Ubuntu viene preempaquetado Systemd, lo que nos permite crear un servicio con el cual GitBucket se iniciará y mantendrá automáticamente en el sistema.

Utilizando nano, cree un nuevo archivo de unidad en el /etc/systemd/systemdirectorio.

sudo nano /etc/systemd/system/gitbucket.service

Luego, copie los siguientes contenidos en el archivo.

[Unit]
Description=GitBucket
After=network.target
[Service]
ExecStart=/usr/bin/java -jar /home/gitbucket/gitbucket.war --port 8080
ExecStop=/bin/kill -SIGINT $MAINPID
Type=simple
User=gitbucket
[Install]
WantedBy=multi-user.target

Este archivo de unidad define el comportamiento básico de inicio y apagado de GitBucket, y ejecuta el servicio bajo nuestro usuario del sistema sin privilegios en la interfaz de red solo local.

Si ha cambiado el número de puerto que escuchará GitBucket, cambie el --portargumento del ExecStartcomando.

Guarde (" CTRL+O") el nuevo archivo de unidad y luego salga del editor (" CTRL+X"). Deberá volver a cargar Systemd para que se descubra el nuevo archivo de unidad.

sudo systemctl daemon-reload

Después de que Systemd se haya recargado, verifique que se descubrió y cargó la nueva unidad.

sudo systemctl status gitbucket

Debería ver el siguiente resultado.

gitbucket.service - GitBucket
   Loaded: loaded (/etc/systemd/system/gitbucket.service; disabled; vendor preset: enabled)
   Active: inactive (dead)

Finalmente, habilite la nueva unidad para que se inicie automáticamente cuando su servidor se inicie y luego inicie el servicio por primera vez.

sudo systemctl enable gitbucket
sudo systemctl start gitbucket

Una vez que el servicio haya comenzado, podrá acceder a GitBucket desde su navegador utilizando la dirección IP y el número de puerto nuevamente.

Configurar el proxy inverso de Nginx

Si bien uno puede exponer GitBucket directamente a través del puerto 8080, puede mejorar el rendimiento y configurar características como HTTP / 2, cifrado TLS y reglas de almacenamiento en caché exponiendo GitBucket a través de Nginx.

Configuración inicial de Nginx

Si aún no ha instalado Nginx, actualice sus listas de paquetes.

sudo apt update

Luego instale el paquete Nginx.

sudo apt install nginx

Una vez que se haya instalado Nginx, verifique que pueda acceder al servidor web a través de la dirección IP de su servidor sin el número de puerto (es decir, http://203.0.113.0o http://example.com). Si tiene éxito, verá la página de inicio predeterminada de Nginx para Ubuntu.

Crear el proxy inverso

Copiaremos la configuración predeterminada del sitio /etc/nginx/sites-availablecomo punto de partida para el proxy inverso.

sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/gitbucket

Abra el archivo de configuración recién creado con nano.

sudo nano /etc/nginx/sites-available/gitbucket

Localice el location /bloque existente en la línea 43.

location / {
  # First attempt to serve request as file, then
  # as directory, then fall back to displaying a 404.
  try_files $uri $uri/ =404;
}

Actualmente, Nginx intentará devolver archivos ubicados en los /var/www/htmlque coincidan las HTTPsolicitudes entrantes . Tendremos que cambiar este comportamiento configurando un proxy inverso en este bloque, que enviará todas las solicitudes HTTP realizadas a nuestro servidor Nginx a la instancia de GitBucket. Actualice el location /bloque para que coincida con lo siguiente.

location / {
    proxy_pass              http://localhost:8080; # The address GitBucket is listening on
    proxy_set_header        Host $host;
    proxy_set_header        X-Real-IP $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_connect_timeout   150;
    proxy_send_timeout      100;
    proxy_read_timeout      100;
    proxy_buffers           4 32k;

    client_max_body_size    512m; # Needed for large Git operations over HTTP
    client_body_buffer_size 128k;
}

Si cambió el número de puerto en el que GitBucket escuchará, actualice la proxy_passopción para reflejar esto.

Para habilitar nuestra nueva configuración, deberá deshabilitar la configuración predeterminada existente en /etc/nginx/sites-enabled, y luego vincular nuestra nueva configuración a /etc/nginx/sites-enabledtravés de lo siguiente.

sudo rm /etc/nginx/sites-enabled/default
sudo ln -s /etc/nginx/sites-available/gitbucket /etc/nginx/sites-enabled/gitbucket

Una vez que se haya habilitado el archivo de configuración, verifique si hay errores de sintaxis.

sudo nginx -t

Luego, reinicie el servidor Nginx para habilitar nuestra nueva configuración del sitio.

sudo systemctl restart nginx

Ahora debería poder acceder a su instalación de GitBucket en la dirección pública de su servidor sin un número de puerto.

Asegurar el proceso de GitBucket desde Internet público

Actualmente, nuestra instancia de GitBucket está escuchando en la interfaz de red pública de nuestro servidor . Esto permitirá a los usuarios omitir el proxy Nginx conectándose a la dirección en la que GitBucket está escuchando actualmente, lo que probablemente no es deseado. Tendremos que modificar el archivo de unidad que creamos anteriormente para resolver esto. Abra el archivo de la unidad con nano.

sudo nano /etc/systemd/system/gitbucket.service

Anexar --host 127.0.0.1al ExecStartcomando, así.

...
ExecStart=/usr/bin/java -jar /home/gitbucket/gitbucket.war --port 8080 --host 127.0.0.1
...

Esto hará que GitBucket solo acepte conexiones en la interfaz de red local de nuestro servidor. Una vez más, guarde (" CTRL+O") el archivo, cierre (" CTRL+X") el editor, vuelva a cargar Systemd y reinicie nuestra unidad GitBucket.

sudo systemctl daemon-reload
sudo systemctl restart gitbucket

Si está utilizando el cortafuegos de Vultr, también debe eliminar cualquier regla de puerto que haya agregado para acceder al servidor GitBucket durante la configuración inicial.