DEV Community: Javier Carmona Gallegos

[MATERIAL]- Taller Manos a la obra con git y github

Javier Carmona Gallegos — Mon, 20 Oct 2025 20:56:08 +0000

Hi Dev.to Community this post is just a setup focused for college students for a workshop (CIISTI 2025).

Lo prometido es Deuda muchachos aqui es el repo, recuerden que el repo tiene las slides de la presentacion:

https://github.com/doncarmone/test-html-firststeps-II

Inicio:

Para el taller vamos a necesitar git y una cuenta de github para sacarle el provecho al tiempo del taller.

En el siguiente link vamos a poder descargar la herramienta:

Selecciona a segun tu sistema operativo

https://git-scm.com/install/

Setup de git

Setup en Windows 10/11

El setup es una instalación comúm de "next" "next"

Como recomendacion en esta pantalla seleccione NANO

Y continuar con el setup hasta finalizar. Si requiere un tutorial paso a paso siga el siguiente video de youtube:

https://www.youtube.com/watch?v=zyrhDewSa2c

Setup en MacOS (Intel/Apple Silicon chips serie M )

Por lo general git ya viene preinstalado en Macos, para comprobar si git ya esta instalado, abra una terminal presionando la tecla command + espacio para abrir spotlight, busque terminal

Ejecute el siguiente comando:

git --version

Si la respuesta de la terminal es similar a la de la imagen ya tienes instalado git.

Si no tienes git siga las siguientes instrucciones:

En la misma terminal ejecute

xcode-select --install

Al terminar ejecute

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Y al completar la instlacion cierre la terminal y vuelva a abrirla para refrescar los cambios.
En la terminal recien abierta ejecute:

brew install git

Al terminar la instalación ejecute git --version para comprobar la salida.

Setup en Linux (Ubuntu)

Se elige Ubuntu por ser la distro más popular.

Por lo general al igual que Macos, git ya vienen instalado en casi cualquier distro completa de linux. para comprobar la instalacion abra una terminal y ejecute:

git --version

Si el comando no responde, puede instalar git usando el siguiente comando:

sudo apt install git

Crear cuenta de github con el correo institucional

Primero vamos a entrar a Github vamos a dar click en sign in.

Luego vamos escoger continuar con google.

Seleccione su cuenta institucional.

De en continuar.

Termine el registro con un nombre de usuario que usted recuerde.
Al finalizar deberia ver algo parecido a esta pantalla.

Con esto terminamos la creacion de la cuenta de github.

Vincular mi instalacion de git con mi cuenta de github.

En cualquiera que sea su sistema operativo, abra una terminal y ejecute los siguientes comandos:

Coloca tu nombre y tu correo tal cual lo hiciste en tu cuenta de github.

git config --global user.name "Tu Nombre"
git config --global user.email "tu_email@example.com"

En mi caso seria algo como:

git config --global user.name "Javier Carmona"
git config --global user.email "13030617@itcelaya.edu.mx"

Ahora crearemos una llave ssh, ejecute el siguiente comando:

Recuerda colocar tu correo de github

ssh-keygen -t ed25519 -C "tu_email@example.com"

En mi caso seria algo como:

ssh-keygen -t ed25519 -C "13030617@itcelaya.edu.mx"

Te va a pedir un passphrase, de momento dejelo vacio aunque es altamente recomendable colocar algo, pero para fines didacticos vamos a dejarlo en blanco de enter hata ver algo asi

Esto genera una llave ssh en el directorio local de su computadora, en:
Windows es en: /c/Users/TuUsuario/.ssh/id_ed25519

En macos es en: /Users/[TuUsuario]/.ssh/id_ed25519

En Linux es en: /home/[TuUsuario]/.ssh/id_ed25519

Para finalizar ejecutaremos los siguientes comandos:

eval "$(ssh-agent -s)"

ssh-add ~/.ssh/id_ed25519

Ahora regresamos al navegador y vamos a la cuenta de github, selecionamos la imagen de usuario en la parte superior derecha, despliegue el menu y seleccione Settings o Ajustes.

Veremos la pantalla de ajustes y daremos click a donde dice: SSH and GPG Keys o Llaves SSH y GPG

Seleccione New SSH Key

Esto les abrirá una nueva ventana para dar de alta la llave ssh
En titulo coloque algo representativo de esa llave, recomiendo que sea la marca o modelo de su laptop para que recuerde que esa llave pertence a su a ese equipo.
En el textarea donde dice key pegaremos la llave publica, regresamos a la terminal de su sistema operativo.

En windows en colocaremos el siguiente comando (Estos comandos nos sirven para copiar al portapapeles la llave publica que generamos):

clip < ~/.ssh/id_ed25519.pub

En macos colocaremos:

pbcopy < ~/.ssh/id_ed25519.pub

En Linux:

cat ~/.ssh/id_ed25519.pub

Copie el resultado de la llave.

Una vez hecho esto, pegue la llave en el textarea y guarde la llave.

Para comprobar que la vinculación fue correcta ejecute en su terminal el siguiente comando le preguntara que si quiere conectarse a github coloque yes :

ssh -T git@github.com

Deberia ver una salida parecida a esto:

Si fue correcta la salida ya estas listo para el taller, si tuviste problemas con la instalacion, la viculacion o algun detalle, estare el dia de la platica y el taller dando asesorias para poder llegar al taller con todo.

Guide to Deploying .NET Web API on Linux Servers with Auto-Restart using systemd

Javier Carmona Gallegos — Mon, 07 Jul 2025 20:51:07 +0000

Let's level up your .NET deployment. To run your Web API on Linux like a pro, you need it to bounce back automatically from any failure. We'll show you how to harness systemd —the gold standard for managing services—to ensure your app relaunches flawlessly after a crash or server restart.

Step 1: Your Setup Checklist

Before we dive in, let's make sure you have the right gear:

🖥️ A Linux Server: Any modern distro like Ubuntu or CentOS will do, as long as it's connected to the internet.
🔑 Root Rights: You'll need sudo or root access to install software and configure the service.
⚙️ .NET SDK: The star of the show. If you don't have it installed yet, grab the right version for your distro from the official site .NET website. and verify the installation by running the next commands:

dotnet --list-sdks

dotnet --list-runtimes

dotnet --version

Step 2: Install the .NET SDK

If you don't have the .NET SDK yet, now's the time. For Ubuntu or other Debian-based systems, pop open your terminal and run:

# Update package index
sudo apt update

# Install the .NET SDK
sudo apt install dotnet-sdk-8.0

Step 3 (Optional): Don't Have a Project? No Problem.

Need a sample app to work with? Let's create a boilerplate .NET Web API right now. Just run the following from your terminal.

Create a new Web API project:

dotnet new webapi -n MyWebApi
cd MyWebApi

Publish Your Application:

Publish the application to a folder for deployment:

dotnet publish -c Release -o ./publish

Step 4: Create a Systemd Service File

Create a service file in /etc/systemd/system/. Replace mywebapi with your application's name:

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

Add the following configuration to the file:

[Unit]
Description=My .NET Web API
After=network.target

[Service]
WorkingDirectory=/path/to/your/project/publish
ExecStart=/usr/bin/dotnet /path/to/your/project/publish/MyWebApi.dll
Restart=always
RestartSec=10
SyslogIdentifier=mywebapi
User=yourusername
Environment=ASPNETCORE_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

WorkingDirectory: The directory containing your published application.
ExecStart: The command to start your application.
User: The Linux user that should run the service (ensure this user has access to the application files).
Environment: Set the environment to Production for optimized performance.

Step 5: Start and Enable the Service

Reload systemd to recognize the new service:

sudo systemctl daemon-reload

Now, manage the service:

sudo systemctl start mywebapi.service

sudo systemctl enable mywebapi.service

sudo systemctl status mywebapi.service

sudo systemctl stop mywebapi.service

Step 6: Verify Your Deployment

Access your application via a web browser by navigating to http://your_domain_or_ip/.
Use tools like curl or Postman to test your API endpoints.

curl http://example.com

Step 7: Monitor Logs

If you encounter issues, check the logs for your service:

sudo journalctl -u mywebapi.service -f

Mission Accomplished

There you have it. Your .NET Web API is now officially deployed on Linux with a systemd safety net. You've built a robust service that won't go down without a fight, automatically restarting whenever there's a hiccup.

The next level? Slip it behind a reverse proxy for a production-ready setup. Any questions? You know where to find us.