{"id":638,"date":"2024-10-16T19:15:00","date_gmt":"2024-10-16T17:15:00","guid":{"rendered":"https:\/\/blog.pirulug.com\/?p=638"},"modified":"2024-10-16T19:15:00","modified_gmt":"2024-10-16T17:15:00","slug":"configurando-ci-cd-en-un-vps-con-debian-y-hestiacp","status":"publish","type":"post","link":"https:\/\/blog.pirulug.com\/?p=638","title":{"rendered":"Configurando CI\/CD en un VPS con Debian y HestiaCP"},"content":{"rendered":"

En este post, te mostrar\u00e9 c\u00f3mo configurar un flujo de Continuous Integration (CI) y Continuous Deployment (CD) en tu VPS que corre Debian, utilizando HestiaCP y GitHub. Este m\u00e9todo te permitir\u00e1 desplegar autom\u00e1ticamente los cambios de la rama deploy<\/code> de tu repositorio de GitHub en tu servidor. Sigue los pasos a continuaci\u00f3n.<\/p>\n

1. Configuraciones iniciales<\/h3>\n

Aseg\u00farate de tener HestiaCP instalado y funcionando en tu VPS. Crea una cuenta de usuario y dominio en HestiaCP para el proyecto donde se har\u00e1 el despliegue. Tambi\u00e9n, instala las dependencias necesarias, como git<\/code>.<\/p>\n

2. Habilitar funciones de ejecuci\u00f3n en PHP<\/h3>\n

Para ejecutar comandos de shell desde PHP, necesitas habilitar shell_exec<\/code> y exec<\/code> en el archivo php.ini<\/code>. Busca las siguientes l\u00edneas y aseg\u00farate de que no est\u00e9n comentadas:<\/p>\n

disable_functions =<\/code><\/pre>\n
Esto permitir\u00e1 que tus scripts PHP ejecuten comandos de shell, lo cual es esencial para nuestro flujo de trabajo de despliegue.<\/p>\n
3. Configurar claves SSH<\/h3>\n
Genera una clave SSH en tu VPS y agr\u00e9gala tanto al usuario admin<\/code> de HestiaCP como al usuario root<\/code>:<\/p>\n
ssh-keygen -t ed25519 -C "tu_email@example.com"<\/code><\/pre>\n
Agrega la clave p\u00fablica a tu cuenta de GitHub en \u00abSettings\u00bb > \u00abSSH and GPG keys\u00bb. Esto permitir\u00e1 que tu VPS se conecte a GitHub sin necesidad de ingresar credenciales cada vez que se realice un despliegue.<\/p>\n
Si ya tienes una clave SSH generada para el usuario root<\/code> y deseas copiarla para el usuario admin<\/code>, sigue estos pasos:<\/p>\n
    \n
  1. Inicia sesi\u00f3n como root<\/code> y copia las claves SSH:<\/li>\n
    cp \/root\/.ssh\/id_rsa \/home\/admin\/.ssh\/<\/code><\/pre>\n
    cp \/root\/.ssh\/id_rsa.pub \/home\/admin\/.ssh\/<\/code><\/pre>\n
  2. Ajusta los permisos para que sean correctos:<\/li>\n
    chown admin:admin \/home\/admin\/.ssh\/id_rsa<\/code><\/pre>\n
    chown admin:admin \/home\/admin\/.ssh\/id_rsa.pub<\/code><\/pre>\n
    chmod 600 \/home\/admin\/.ssh\/id_rsa<\/code><\/pre>\n
    chmod 644 \/home\/admin\/.ssh\/id_rsa.pub<\/code><\/pre>\n
    chmod 700 \/home\/admin\/.ssh<\/code><\/pre>\n
  3. Aseg\u00farate de que la clave de host de GitHub est\u00e9 en el archivo known_hosts<\/code>:<\/li>\n
    sudo -u admin ssh-keyscan -H github.com >> \/home\/admin\/.ssh\/known_hosts<\/code><\/pre>\n
  4. Prueba la conexi\u00f3n SSH como el usuario admin<\/code>:<\/li>\n
    sudo -u admin ssh -T git@github.com<\/code><\/pre>\n<\/ol>\n
    4. Crear el script de despliegue<\/h3>\n
    Crea un archivo git-deploy.sh<\/code> en tu servidor que contendr\u00e1 los comandos para actualizar tu proyecto:<\/p>\n
    #!\/bin\/bash\n{\n  echo "========================================"\n  echo "Running deploy script..."\n  echo "Execution time: $(date)"\n  echo "Current user: $(whoami)"\n  echo "Current directory: $(pwd)"\n\n  cd \/home\/admin\/web\/pfinteractive.net.pe\/public_html || { echo "Failed to change directory"; exit 1; }\n  git fetch origin || { echo "Failed to fetch changes"; exit 1; }\n  git reset --hard origin\/deploy || { echo "Failed to reset"; exit 1; }\n  git clean -fd || { echo "Failed to clean"; exit 1; }\n\n  echo "Deployment completed at: $(date)"\n  echo "========================================"\n} >> \/home\/admin\/web\/pfinteractive.net.pe\/deploy\/deploy.log 2>&1\n<\/code><\/pre>\n
    No olvides hacer el script ejecutable:<\/p>\n
    chmod +x git-deploy.sh<\/code><\/pre>\n
    5. Configurar el webhook en GitHub<\/h3>\n
    Ve a tu repositorio en GitHub, en \u00abSettings\u00bb > \u00abWebhooks\u00bb, agrega un nuevo webhook que apunte a un archivo PHP que crear\u00e1s en tu servidor. Este archivo ser\u00e1 responsable de recibir el evento de push<\/code> y ejecutar el script de despliegue.<\/p>\n
    6. Crear el archivo PHP para recibir el webhook<\/h3>\n
    Crea un archivo git-deploy.php<\/code> en tu servidor:<\/p>\n
    <?php\n$secret = 'tu_secreto_webhook';\n$payload = file_get_contents('php:\/\/input');\n$sig_header = $_SERVER['HTTP_X_HUB_SIGNATURE_256'];\n$hash = 'sha256=' . hash_hmac('sha256', $payload, $secret);\n\nif (hash_equals($hash, $sig_header)) {\n    $output = shell_exec('sh \/home\/admin\/web\/pfinteractive.net.pe\/public_html\/git-deploy.sh 2>&1');\n    file_put_contents('\/home\/admin\/web\/pfinteractive.net.pe\/public_html\/deploy.log', $output, FILE_APPEND);\n    if ($output === null) {\n        echo "Error: Failed to execute shell command.";\n    } else {\n        echo "Success";\n    }\n} else {\n    http_response_code(403);\n}\n?><\/code><\/pre>\n
    Define $secret<\/code> con una cadena aleatoria y agr\u00e9gala al webhook en GitHub para validar la autenticidad del evento.<\/p>\n
    7. Probar el flujo de trabajo<\/h3>\n
    Finalmente, realiza un push<\/code> a la rama deploy<\/code> de tu repositorio y verifica que el VPS actualice autom\u00e1ticamente tu proyecto. Puedes revisar el archivo de log para verificar el estado del despliegue:<\/p>\n
    cat \/home\/admin\/web\/pfinteractive.net.pe\/public_html\/deploy.log<\/code><\/pre>\n
    Con esta configuraci\u00f3n, tendr\u00e1s un flujo de trabajo CI\/CD eficiente que te permitir\u00e1 gestionar tus despliegues de manera sencilla y r\u00e1pida. \u00a1Feliz codificaci\u00f3n!<\/p>\n","protected":false},"excerpt":{"rendered":"
    En este post, te mostrar\u00e9 c\u00f3mo configurar un flujo de Continuous Integration (CI) y Continuous Deployment (CD) en tu VPS que corre Debian, utilizando HestiaCP y GitHub. Este m\u00e9todo te permitir\u00e1 desplegar autom\u00e1ticamente los cambios de la rama deploy de tu repositorio de GitHub en tu servidor. Sigue los pasos a continuaci\u00f3n. 1. Configuraciones iniciales […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[60],"class_list":["post-638","post","type-post","status-publish","format-standard","hentry","category-sin-categoria","tag-github"],"_links":{"self":[{"href":"https:\/\/blog.pirulug.com\/index.php?rest_route=\/wp\/v2\/posts\/638","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.pirulug.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.pirulug.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.pirulug.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.pirulug.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=638"}],"version-history":[{"count":0,"href":"https:\/\/blog.pirulug.com\/index.php?rest_route=\/wp\/v2\/posts\/638\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.pirulug.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=638"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.pirulug.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=638"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.pirulug.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=638"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}