Instalación y configuración de una instancia GitLab CE en Lightsail - Amazon Lightsail
Paso 1: leer la documentación de BitnamiPaso 2: Obtenga la contraseña de la aplicación predeterminada para acceder al área de administración de GitLab CEPaso 3: asociar una dirección IP estática a la instanciaPaso 4: iniciar sesión en el área de administradores del sitio web de GitLab CEPaso 5: Dirija el tráfico de su nombre de dominio registrado a su sitio web GitLab CEPaso 6: Configure HTTPS su sitio web GitLab de CEPaso 7: Lea la documentación de la GitLab CE y continúe configurando su sitio webPaso 8: crear una instantánea de la instancia

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Instalación y configuración de una instancia GitLab CE en Lightsail

Estos son algunos pasos que debe seguir para empezar una vez que su instancia de GitLab CE esté en funcionamiento en Amazon Lightsail:

Contenido

Paso 1: leer la documentación de Bitnami

Lea la documentación de Bitnami para aprender a configurar su aplicación GitLab CE. Para obtener más información, consulte el GitLab CE empaquetado por Bitnami For. Nube de AWS

Paso 2: Obtenga la contraseña de la aplicación predeterminada para acceder al área de administración de GitLab CE

Complete el siguiente procedimiento para obtener la contraseña de aplicación predeterminada necesaria para acceder al área de administración de su sitio web de GitLab CE. Para obtener más información, consulte Obtener el nombre de usuario y la contraseña de la aplicación para su instancia de Bitnami en Amazon Lightsail.

  1. En la página de administración de instancias, en la pestaña Conectar, selecciona Conectar mediante SSH.

    Connect mediante SSH la consola Lightsail

  2. Una vez conectado, escriba el siguiente comando para obtener la contraseña de aplicación:

    cat $HOME/bitnami_application_password

    Debe obtener una respuesta similar a la del ejemplo siguiente, que contiene la contraseña de aplicación predeterminada:

    Contraseña de aplicación predeterminada Bitnami.

Paso 3: asociar una dirección IP estática a la instancia

La dirección IP pública asignada a la instancia la primera vez que la cree cambiará cada vez que detenga e inicie la instancia. Debe crear una dirección IP estática y adjuntarla a la instancia para asegurarse de que la dirección IP pública no cambie. Más adelante, cuando utilice un nombre de dominio registrado, por ejemploexample.com, con su instancia, no tendrá que actualizar los DNS registros de su dominio cada vez que detenga e inicie la instancia. Puede adjuntar una IP estática a una instancia.

En la página de administración de instancias, en la pestaña Networking (Redes), elija Create a static IP (Crear una IP estática) o Attach static IP (Adjuntar IP estática) (si creó previamente una IP estática que puede adjuntar a la instancia), y siga las instrucciones que aparecen en la página. Para obtener más información, consulte Creación de una IP estática y asociación a una instancia.

Adjunte una dirección IP estática a la consola de Lightsail

Después de asociar la nueva dirección IP estática a la instancia, debe completar los siguientes pasos para que la aplicación conozca la nueva dirección IP estática.

  1. Anote la dirección IP estática de la instancia. Aparece en la sección de encabezado de la página de administración de instancias.

    Dirección IP pública o estática de una instancia de Lightsail

  2. En la página de administración de instancias, en la pestaña Conectar, selecciona Conectar mediante SSH.

    Conéctese a la instancia mediante SSH

  3. Una vez lista la conexión, ingrese el comando siguiente. Reemplazar <StaticIP> con la nueva dirección IP estática de la instancia.

    sudo /opt/bitnami/configure_app_domain --domain <StaticIP>

    Ejemplo:

    sudo /opt/bitnami/configure_app_domain --domain 203.0.113.0

    Debería ver una respuesta similar a la del siguiente ejemplo. La aplicación de su instancia ya debe conocer la nueva dirección IP estática.

    Resultado de la herramienta de configuración de dominios

Paso 4: iniciar sesión en el área de administradores del sitio web de GitLab CE

Ahora que tiene la contraseña de usuario predeterminada, vaya a la página de inicio del sitio web de GitLab CE e inicie sesión en el área de administración. Una vez que haya iniciado sesión, puede comenzar a personalizar su sitio web y realizar cambios administrativos. Para obtener más información sobre lo que puede hacer en GitLab CE, consulte la sección Paso 7: Lea la documentación de GitLab CE y continúe configurando su sitio web más adelante en esta guía.

  1. En la página de administración de instancias, bajo la pestaña Conectarse, anote la dirección IP pública de su instancia. La dirección IP pública también se muestra en la sección de encabezado de la página de administración de instancias.

    Dirección IP pública de una instancia

  2. Vaya a la dirección IP pública de su instancia, por ejemplo, visitando http://203.0.113.0.

    Debería aparecer la página de inicio de su sitio web de GitLab CE. Es posible que también aparezca una advertencia del navegador indicando que la conexión no es privada, no es segura o que pone en riesgo la seguridad. Esto se debe a que su instancia GitLab CE aún no tiene un TLS certificadoSSL/aplicado. En la ventana del navegador, seleccione Opciones avanzadas, Detalles, o Más información para ver las opciones disponibles. A continuación, elija continuar con el sitio web aunque no sea privado o seguro.

  3. Inicie sesión con el nombre de usuario (root) predeterminado y la contraseña predeterminada recuperada anteriormente en esta guía.

    Aparece el panel de administración de GitLab CE.

    El panel de administración de GitLab CE

Paso 5: Dirija el tráfico de su nombre de dominio registrado a su sitio web GitLab CE

Para dirigir el tráfico de tu nombre de dominio registrado, por ejemploexample.com, a tu sitio web de GitLab CE, añades un registro al sistema de nombres de dominio (DNS) de tu dominio. DNSPor lo general, los registros se administran y alojan en el registrador en el que registraste tu dominio. Sin embargo, le recomendamos que transfiera la administración de los DNS registros de su dominio a Lightsail para que pueda administrarlos mediante la consola de Lightsail.

En la página de inicio de la consola Lightsail, en la pestaña Redes, elija DNS Crear zona y, a continuación, siga las instrucciones de la página. Para obtener más información, consulte Crear una DNS zona para administrar los registros de DNS su dominio.

Crear una DNS zona en la consola de Lightsail

Una vez que su nombre de dominio dirija el tráfico a su instancia, debe completar el siguiente procedimiento para que GitLab CE conozca el nombre de dominio.

  1. En la página de administración de instancias, en la pestaña Conectar, selecciona Conectar mediante SSH.

    Conéctese a la instancia mediante SSH

  2. Una vez lista la conexión, ingrese el comando siguiente. Reemplazar <DomainName> con el nombre de dominio que dirige el tráfico a tu instancia.

    sudo /opt/bitnami/configure_app_domain --domain <DomainName>

    Ejemplo:

    sudo /opt/bitnami/configure_app_domain --domain example.com

    Debería ver una respuesta similar a la del siguiente ejemplo. Su instancia de GitLab CE ahora debería conocer el nombre de dominio.

    Resultado de la herramienta de configuración de dominios

    Si ese comando falla, es posible que estés usando una versión anterior de la instancia GitLab CE. En cambio, intente ejecutar los siguientes comandos. Reemplazar <DomainName> con el nombre de dominio que dirige el tráfico a tu instancia.

    cd /opt/bitnami/apps/gitlab
sudo ./bnconfig --machine_hostname <DomainName>

    Después de ejecutar esos comandos, ingrese el siguiente comando para evitar que se ejecute la herramienta bnconfig de forma automática cada vez que se reinicia el servidor.

    sudo mv bnconfig bnconfig.disabled

A continuación, debe generar y configurar un TLS certificadoSSL/para habilitar HTTPS las conexiones para su sitio web de GitLab CE. Para obtener más información, continúe con la siguiente sección de esta guía llamada Paso 6: Configuración HTTPS para su sitio web de GitLab CE.

Paso 6: Configure HTTPS su sitio web GitLab de CE

Complete el siguiente procedimiento para configurarlo HTTPS en su sitio web de GitLab CE. Estos pasos le muestran cómo utilizar el cliente Lego, que es una herramienta de línea de comandos para solicitar los TLS certificados Let's EncryptSSL/.

importante

Antes de comenzar con este procedimiento, asegúrese de haber configurado su dominio para enrutar el tráfico a su instancia de GitLab CE. De lo contrario, se SSL producirá TLS un error en el proceso de validación del certificado/. Para enrutar el tráfico de su nombre de dominio registrado, añada un registro al DNS de su dominio. DNSlos registros normalmente se administran y alojan en el registrador en el que registraste tu dominio. Sin embargo, le recomendamos que transfiera la administración de los DNS registros de su dominio a Lightsail para que pueda administrarlos mediante la consola de Lightsail.

En la página de inicio de la consola Lightsail, en la pestaña Dominios DNS y, seleccione DNS Crear zona y, a continuación, siga las instrucciones de la página. Para obtener más información, consulte Crear una DNS zona para administrar los DNS registros de su dominio en Lightsail.

  1. En la página de administración de instancias, en la pestaña Conectar, selecciona Conectar mediante SSH.

    Connect mediante SSH la consola Lightsail

  2. Después de conectarse, ingrese el siguiente comando para cambiar el directorio a uno temporal (/tmp).

    cd /tmp

  3. Ingrese el siguiente comando para descargar la versión más reciente del cliente Lego. Este comando descarga un archivo de paquete de cintas (tar).

    curl -Ls https://api.github.com/repos/xenolf/lego/releases/latest | grep browser_download_url | grep linux_amd64 | cut -d '"' -f 4 | wget -i -

  4. Ingrese el siguiente comando para descomprimir los archivos del archivo tar. Reemplazar X.Y.Z con la versión del cliente de Lego que descargaste.

    tar xf lego_vX.Y.Z_linux_amd64.tar.gz

    Ejemplo:

    tar xf lego_v4.7.0_linux_amd64.tar.gz

  5. Ingrese el siguiente comando para crear el directorio /opt/bitnami/letsencrypt al que moverá los archivos del cliente Lego.

    sudo mkdir -p /opt/bitnami/letsencrypt

  6. Ingrese el siguiente comando para mover los archivos de cliente Lego al nuevo directorio que ha creado.

    sudo mv lego /opt/bitnami/letsencrypt/lego

  7. Ingrese los siguientes comandos uno por uno para detener los servicios de aplicaciones que se ejecutan en la instancia.

    sudo service bitnami stop
sudo service gitlab-runsvdir stop

  8. Ingresa el siguiente comando para usar el cliente Lego para solicitar un TLS certificado Let's EncryptSSL/.

    sudo /opt/bitnami/letsencrypt/lego --tls --email="EmailAddress" --domains="RootDomain" --domains="WwwSubDomain" --path="/opt/bitnami/letsencrypt" run

    En el comando, sustituya los siguientes valores de ejemplo por los suyos:

    • EmailAddress: su dirección de correo electrónico para las notificaciones de registro.

    • RootDomain— El dominio raíz principal que enruta el tráfico a su sitio web de GitLab CE (por ejemplo,example.com).

    • WwwSubDomain— El www subdominio del dominio raíz principal que enruta el tráfico a su sitio web de GitLab CE (por ejemplo,www.example.com).

      Puede especificar varios dominios para el certificado especificando parámetros de --domains adicionales en su comando. Cuando especificas varios dominios, Lego crea un certificado de nombres alternativos de asunto (SAN) que da como resultado que solo un certificado sea válido para todos los dominios que especifiques. El primer dominio de la lista se añade como «CommonName» del certificado y el resto se añade como «DNSNames» a la SAN extensión del certificado.

    Ejemplo:

    sudo /opt/bitnami/letsencrypt/lego --tls --email="user@example.com" --domains="example.com" --domains="www.example.com" --path="/opt/bitnami/letsencrypt" run

  9. Pulsa Y e Intro cuando se le solicite aceptar los términos del servicio.

    Debería ver una respuesta similar a la del siguiente ejemplo.

    Respuesta correcta del cliente de Lego a la solicitud de certificado

    Si fue correcta, se guarda un conjunto de certificados en el directorio /opt/bitnami/letsencrypt/certificates. Este conjunto incluye el archivo de certificado del servidor (por ejemplo, example.com.crt) y el archivo de clave de certificado de servidor (por ejemplo, example.com.key).

  10. Ingrese los siguientes comandos uno por uno para cambiar el nombre de los certificados existentes de la instancia. Más adelante, sustituirá estos certificados existentes por los nuevos certificados de Let's Encrypt.

    sudo mv /etc/gitlab/ssl/server.crt /etc/gitlab/ssl/server.crt.old
sudo mv /etc/gitlab/ssl/server.key /etc/gitlab/ssl/server.key.old
sudo mv /etc/gitlab/ssl/server.csr /etc/gitlab/ssl/server.csr.old

  11. Introduzca los siguientes comandos uno por uno para crear enlaces simbólicos para sus nuevos certificados de Let's Encript en el /etc/gitlab/ssl directorio, que es el directorio de certificados predeterminado de su instancia GitLab CE.

    sudo ln -sf /opt/bitnami/letsencrypt/certificates/Domain.key /etc/gitlab/ssl/server.key
sudo ln -sf /opt/bitnami/letsencrypt/certificates/Domain.crt /etc/gitlab/ssl/server.crt

    En el comando, sustituya Domain por el dominio raíz principal que especificó al solicitar sus certificados de Let's Encrypt.

    Ejemplo:

    sudo ln -sf /opt/bitnami/letsencrypt/certificates/example.com.key /etc/gitlab/ssl/server.key
sudo ln -sf /opt/bitnami/letsencrypt/certificates/example.com.crt /etc/gitlab/ssl/server.crt

  12. Ingrese los siguientes comandos uno por uno para cambiar los permisos de los nuevos certificados de Let's Encrypt en el directorio al que los ha movido.

    sudo chown root:root /etc/gitlab/ssl/server*
sudo chmod 600 /etc/gitlab/ssl/server*

  13. Introduzca el siguiente comando para reiniciar los servicios de la aplicación en su instancia GitLab CE.

    sudo service bitnami start

La próxima vez que navegue a su sitio web de GitLab CE con el dominio que configuró, debería ver que se redirige a la HTTPS conexión. Tenga en cuenta que la instancia GitLab CE puede tardar hasta una hora en reconocer los nuevos certificados. Si su sitio web de GitLab CE rechaza la conexión, detenga e inicie la instancia e inténtelo de nuevo.

Paso 7: Lea la documentación de la GitLab CE y continúe configurando su sitio web

Lea la documentación de la GitLab CE para aprender a administrar y personalizar su sitio web. Para obtener más información, consulte la GitLab documentación.

Paso 8: crear una instantánea de la instancia

Después de configurar el sitio web de GitLab CE de la forma que desee, cree instantáneas periódicas de la instancia para hacer una copia de seguridad de la misma. Puede crear instantáneas manualmente o activar las instantáneas automáticas para que Lightsail cree instantáneas diarias por usted. Si hay algún problema con la instancia, puede crear una nueva instancia de reemplazo mediante la instantánea. Para obtener más información, consulte Instantáneas.

En la página de administración de instancias, en la pestaña Snapshot (instantánea), elija Create a snapshot (Crear una instantánea) o elija habilitar las instantáneas automáticas.

Cree una instantánea de instancia en la consola de Lightsail

Para obtener más información, consulte Crear una instantánea de su instancia de Linux o Unix en Amazon Lightsail o Habilitar o deshabilitar instantáneas automáticas para instancias o discos en Amazon Lightsail.