Dev Proxy es una herramienta de línea de comandos que le ayuda a simular comportamientos y errores de las API en la nube para ayudarle a crear aplicaciones resistentes.
En este tutorial, aprenderá a instalar y ejecutar proxy de desarrollo.
Instalación del proxy de desarrollo
La manera más fácil de instalar Proxy de desarrollo es mediante winget. Como alternativa, puede instalar el proxy de desarrollo manualmente.
Para instalar el proxy de desarrollo mediante winget, ejecute el siguiente comando:
winget install Microsoft.DevProxy --silent
Importante
El instalador del proxy de desarrollo agrega una nueva entrada a PATH. Para usar el proxy de desarrollo después de la instalación, debe reiniciar el símbolo del sistema para actualizar la variable de entorno PATH.
Descargar la versión más reciente y extraer los archivos en una carpeta. En este tutorial, se supone que extrae los archivos en una carpeta denominada devproxy ubicada en el directorio principal.
Para iniciar Dev Proxy desde cualquier directorio, agregue su carpeta de instalación a su PATH.
Abra el menú Start.
Escriba Edit environment variables for your account en el cuadro de búsqueda. Seleccione el resultado de la lista para abrir el cuadro de diálogo Environment Variables.
En la sección User variables for <username>, seleccione la fila con el nombre de variable de Path y seleccione el botón Edit....
En el cuadro de diálogo Edit environment variable, seleccione el botón New.
Escriba %USERPROFILE%\devproxy en la nueva fila y seleccione OK.
Para confirmar los cambios, seleccione OK.
Nota
Para probar las características de versión preliminar más recientes, instale la versión beta del proxy de desarrollo.
Para instalar el proxy de desarrollo mediante winget, ejecute el siguiente comando:
winget install Microsoft.DevProxy.Beta --silent
Descargar la versión beta más reciente y extraer los archivos en una carpeta. Siga los pasos de configuración manual como se ha descrito anteriormente.
Para ejecutar la versión beta del proxy de desarrollo, use devproxy-beta
La manera más fácil de instalar Dev Proxy es mediante Homebrew. Como alternativa, puede instalar el proxy de desarrollo manualmente.
Para instalar el proxy de desarrollo mediante Homebrew, ejecute los siguientes comandos:
brew tap dotnet/dev-proxy
brew install dev-proxy
Descargar la versión más reciente y extraer los archivos en una carpeta. En este tutorial, se supone que extrae los archivos en una carpeta denominada devproxy ubicada en el directorio principal.
Para iniciar Dev Proxy desde cualquier directorio, agregue la ubicación de su carpeta de instalación al PATH.
Los pasos siguientes muestran cómo agregar el proxy a PATH al usar zsh shell. Dependiendo del shell que use, el archivo de perfil puede diferir.
Abra el perfil de shell en un editor de texto >~/.zshrc.
Actualice PATH variable de entorno con la ubicación del proxy >export PATH=".:$PATH:$HOME/devproxy".
Vuelva a cargar el perfil >source ~/.zshrc.
Nota
Para probar las características de versión preliminar más recientes, instale la versión beta del proxy de desarrollo.
Para instalar el proxy de desarrollo mediante Homebrew, ejecute los siguientes comandos:
brew tap dotnet/dev-proxy
brew install dev-proxy-beta
Descargar la versión beta más reciente y extraer los archivos en una carpeta. Siga los pasos de configuración manual como se ha descrito anteriormente.
Para ejecutar la versión beta del proxy de desarrollo, use devproxy-beta
La manera más fácil de instalar el proxy de desarrollo es mediante el script de instalación. Como alternativa, puede instalar el proxy de desarrollo manualmente.
Descargar la versión más reciente y extraer los archivos en una carpeta. En este tutorial, se supone que extrae los archivos en una carpeta denominada devproxy ubicada en el directorio principal.
Para iniciar Dev Proxy desde cualquier directorio, agregue la ubicación de la carpeta de instalación a su PATH (ruta de acceso).
Los pasos siguientes muestran cómo agregar el proxy a PATH al usar el shell de Bash. Dependiendo del shell que use, el archivo de perfil puede diferir.
Abra el perfil de shell en un editor de texto >~/.bashrc.
Actualice PATH variable de entorno con la ubicación del proxy >export PATH=".:$PATH:$HOME/devproxy".
Vuelva a cargar el perfil >source ~/.bashrc.
Nota
Para probar las características de versión preliminar más recientes, instale la versión beta del proxy de desarrollo.
Descargar la versión beta más reciente y extraer los archivos en una carpeta. Siga los pasos de configuración manual como se ha descrito anteriormente.
Para ejecutar la versión beta del proxy de desarrollo, use devproxy-beta
Iniciar proxy de desarrollo por primera vez
La primera vez que inicie el proxy de desarrollo en la máquina, hay algunos pasos que debe seguir para asegurarse de que el proxy de desarrollo puede interceptar las solicitudes de la máquina y responder correctamente. No tendrás que repetir estos pasos después de la primera ejecución.
Inicie el proxy de desarrollo. Abra una sesión del símbolo del sistema. Introduzca devproxy y presione , luego introduzca.
Certificado de confianza. Dev Proxy instala un certificado denominado Dev Proxy CA. Se muestra una advertencia. Seleccione Yes para confirmar que desea instalar el certificado. El proxy de desarrollo usa este certificado para descifrar el tráfico HTTPS enviado desde la máquina.
Permitir el acceso al firewall. Firewall de Windows bloquea el proxy. Se muestra una advertencia. Seleccione Allow access botón para permitir el tráfico a través del firewall.
Inicie el proxy de desarrollo. Abra una sesión del símbolo del sistema. Escriba devproxy y presione ENTRAR.
Certificado de confianza. Dev Proxy instala un certificado denominado Dev Proxy CA, que usa para descifrar el tráfico HTTPS enviado desde la máquina. Se muestra una advertencia. Presione y para confirmar que desea confiar en el certificado.
Acepte conexiones entrantes. Se muestra una advertencia. Seleccione Allow para confirmar.
Inicie el proxy de desarrollo. Abra una sesión del símbolo del sistema. Escriba devproxy y presione , luego.
Certificado de confianza. Dev Proxy usa un certificado SSL personalizado para descifrar el tráfico HTTPS enviado desde la máquina.
Importante
Las instrucciones siguientes son para Ubuntu. En el caso de otras distribuciones de Linux, los pasos pueden diferir.
Para instalar y confiar en el certificado, en un nuevo terminal, ejecute los siguientes comandos:
El símbolo del sistema muestra la siguiente salida:
info 8 error responses loaded from devproxy-errors.json
info Dev Proxy API listening on http://localhost:8897...
info Dev Proxy Listening on 127.0.0.1:8000...
Hotkeys: issue (w)eb request, (r)ecord, (s)top recording, (c)lear screen
Press CTRL+C to stop Dev Proxy
De forma predeterminada, el proxy de desarrollo está configurado para:
Interceptación de solicitudes realizadas a cualquier punto de conexión de API de marcador de posición JSON
Simulación de respuestas de error de API y limitación de API con una tasa de errores del 50 %
Confirmación de que el proxy de desarrollo funciona correctamente
El proxy de desarrollo intercepta las solicitudes que las aplicaciones de la máquina realizan en direcciones URL que se registran con el proxy de desarrollo. Cuando dev Proxy detecta una solicitud, la pasa a la API (no realiza ninguna acción) o devuelve una respuesta. Vamos a confirmar que el proxy de desarrollo funciona según lo previsto.
En PowerShell, use el cmdlet Invoke-WebRequest para enviar una solicitud GET a la API de marcador de posición JSON.
También puede usar un cliente de API como postman para enviar una solicitud GET a https://jsonplaceholder.typicode.com/posts.
En la línea de comandos en la que se ejecuta el proxy de desarrollo, verá la información sobre la solicitud y la acción que realizó el proxy de desarrollo. De forma predeterminada, Dev Proxy simula una respuesta de error con una probabilidad del 50 %. Si la solicitud no devuelve un error, el proxy de desarrollo lo pasa a través.
req ╭ GET https://jsonplaceholder.typicode.com/posts
time │ 1/31/2025 12:12:14 PM +00:00
skip │ RetryAfterPlugin: Request not throttled
skip │ GenericRandomErrorPlugin: Pass through
api ╰ Passed through
Si dev Proxy devuelve una respuesta de error, verá el mensaje de error en la salida.
req ╭ GET https://jsonplaceholder.typicode.com/posts
time │ 1/31/2025 12:12:37 PM +00:00
skip │ RetryAfterPlugin: Request not throttled
oops ╰ 403 Forbidden
Importante
Si no ve ninguna salida en el símbolo del sistema, es probable que el proxy de desarrollo no intercepte las solicitudes. Consulte la sección problemas comunes para obtener ayuda.
Detener el proxy de desarrollo de forma segura
Cuando ya no necesite que el Dev Proxy esté en funcionamiento, siempre debe detenerlo de manera segura.
Presione Ctrl + C para detener de forma segura el proxy de desarrollo.
Si apaga la sesión del símbolo del sistema, El proxy de desarrollo no anula el registro correctamente como proxy del sistema y puede experimentar algunos problemas comunes.
Paso siguiente
Obtenga información sobre cómo configurar el proxy de desarrollo para sus necesidades. El proxy de desarrollo es muy flexible y admite muchos escenarios diferentes. Obtenga más información sobre cómo configurarlo en su escenario específico.
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
Comentarios de Dev Proxy
Dev Proxy es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios:
Esta certificación mide la capacidad de realizar las siguientes tareas técnicas: Diseño e implementación de procesos y comunicaciones, diseño e implementación de una estrategia de control de código fuente, diseño e implementación de canalizaciones de compilación y versión, desarrollo de un plan de seguridad y cumplimiento e implementación de una estrategia de instrumentación.
