desarrollo de aplicaciones dapr | configuración del entorno

1 Breve introducción de Dapr

Dapr CLI le permite ejecutar el marco Dapr en el entorno de desarrollo local y es compatible con MacOS, Linux y Windows. Instale Dapr en unos segundos y comience a codificar rápidamente.

La CLI de Dapr le permite comenzar con Dapr ejecutándose localmente en su caja de desarrollo y es compatible con MacOS, Linux y Windows. Instale Dapr en segundos y comience a codificar rápidamente.

Soporte de idiomas del marco Dapr: cualquier idioma, en cualquier lugar (nube / nube 《=》 end / Edge)

Empresas que utilizan Dapr:

2 Configuración del entorno

2.1 Requisitos previos para la instalación de Dockers / Requisitos previos (opcional, no obligatorio)

De forma predeterminada, Dapr CLI instalará los binarios de Dapr y configurará un entorno de desarrollador durante la inicialización para ayudarlo a iniciar Dapr fácilmente. Este entorno utiliza contenedores Docker, por lo que es necesario instalar Docker. Si desea ejecutar Dapr sin este entorno y sin depender de Docker, después de instalar la CLI, asegúrese de usar slim init para inicializar Dapr de acuerdo con las instrucciones.

Tenga en cuenta que, si es un usuario nuevo, se recomienda encarecidamente instalar Docker y utilizar el comando init normal.

Tenga en cuenta que si es un usuario nuevo, se recomienda encarecidamente utilizar todos los Docker y utilizar los comandos init habituales.

Notas para la instalación de Docker:

Nota: en Windows, Docker debe ejecutarse en modo Contenedores de Linux
Nota: en Windows, Docker debe ejecutarse en modo contenedor de Linux (se recomienda WSL2)

2.2 Instalar Dapr CLI (requerido)

Plataforma del sistema operativo	Instrucciones de instalación de Dapr CLI
Ventanas	# Instale la última CLI de Windows Dapr en c: Dapr (la ruta raíz de la unidad C está instalada de forma predeterminada) y luego agregue este directorio a la variable de entorno User PATH. Utilice -DaprRoot [ruta] para cambiar el directorio de instalación predeterminado powershell -Command "iwr -useb https://raw.githubusercontent.com/dapr/cli/master/install/install.ps1 \| iex"
Linux	#Instale la última CLI de Linux Dapr en / usr / local / bin wget -q https://raw.githubusercontent.com/dapr/cli/master/install/install.sh -O - \| / bin / bash
Mac OS	#Instale la última CLI de Darwin Dapr en / usr / local / bin curl -fsSL https://raw.githubusercontent.com/dapr/cli/master/install/install.sh \| / bin / bash
De las versiones binarias (instalación binaria)	Cada versión de Dapr CLI incluye varios sistemas operativos y arquitecturas, y estas versiones binarias se pueden descargar e instalar manualmente. Descargue Dapr CLI; Descomprima el paquete (por ejemplo, dapr_linux_amd64.tar.gz, dapr_windows_amd64.zip) Muévelo a donde quieras Para Linux / MacOS-`/usr/local/bin` Para Windows, cree un directorio y agréguelo al sistema [PATH] y agregue este directorio a [PATH] editando las variables de entorno del sistema

2.3 Instalar Runtime

Dapr admite autohospedaje de host local (autohospedado) y hospedaje en modo Kubenetes;

2.3.1 Modo autohospedado del host local (autohospedado)

Hay dos modos al instalar Dapr en esta máquina, uno es el modo completo y el otro es el modo simple:

[ Modo completo ]: se requiere el entorno de Docker para ejecutarse dapr init , descargará automáticamente el tiempo de ejecución de Dapr daprd e iniciará 3 contenedores en Docker:

[Dapr_placement]: la imagen es "daprio / dapr", que se utiliza para el registro de la solicitud de actor de Dapr.
[Dapr_zipkin]: la imagen es "openzipkin / zipkin" y se utiliza para el procesamiento de seguimiento distribuido
[Dapr_redis]: la imagen es "redis" y se utiliza para el almacenamiento estatal y el procesamiento de publicación y suscripción.

Para los usuarios de Linux, si usa sudo para ejecutar los cmds de la ventana acoplable, debe usar sudo dapr init

Nota: Para comprobar si Dapr se ha instalado correctamente, ejecute el comando docker ps desde el símbolo del sistema y compruebe si las imágenes de contenedor daprio / Dapr: latest, dapr_redis y dapr_zipkin se están ejecutando.

Este paso creó los siguientes valores predeterminados:

La carpeta de componentes, más adelante a menos que para Linux / MacOS, la ruta de la carpeta de componentes predeterminada sea Para sistemas Windows, este es el caso %USERPROFILE%\.dapr\components.
Los archivos de componentes en la carpeta de componentes y statestore.yaml.
El archivo de configuración predeterminado es adecuado para Linux / MacOS o Windows para habilitar el seguimiento de llamadas. Puedes usar el logo dapr run.

[ Modo simple ]: No se requiere un entorno Docker, en ejecución dapr init --slim, también descargará automáticamente el daprd en tiempo de ejecución de Dapr y descargará el archivo binario del servicio de colocación.

Nota: Al inicializar Dapr con el indicador - slim, solo se instalan los binarios de tiempo de ejecución de Dapr y los binarios del servicio de ubicación. Cree una carpeta de componentes predeterminada vacía sin un archivo de configuración predeterminado. Durante la ejecución de dapr, los usuarios deben usar - components-path para apuntar al directorio de componentes que contiene archivos de configuración personalizados, o colocar estos archivos en el directorio predeterminado. Para Linux / MacOS, la ruta del directorio de componentes predeterminada es [$ HOME / .dapr / components], para Windows es [ %USERPROFILE%\.dapr\components].

En los dos modos, algunas configuraciones también son diferentes:

Modo completo: se crearán 3 archivos de configuración de componentes predeterminados en el $HOME/.dapr/componentsdirectorio [ ] de Linux / MacOS o en el directorio [ ] de Windows %USERPROFILE%\.dapr\components: pubsub.yaml use el contenedor redis como componente de publicación y suscripción, statestore.yaml use el contenedor redis como componente de almacenamiento de estado y zipkin.yaml exporte el seguimiento distribuido información al contenedor zipkin y agregue el archivo $HOME/.dapr/config.yamlde %USERPROFILE%\.dapr\config.yamlconfiguración predeterminado de [ ] de Linux / MacOS o [ ] de Windows , centrándose en configurar la frecuencia de muestreo del rastreo distribuido en 1.
Modo simple: aunque se components creará el directorio predeterminado , no se creará el archivo de configuración del componente predeterminado. En ejecuciones posteriores, debe crear un archivo de configuración de componentes predeterminado o un archivo de configuración de componentes personalizado para un servicio específico.

= "Instalar una versión de tiempo de ejecución específica | Instalar una versión de tiempo de ejecución específica

Puede usar Dapr init --runtime-version para instalar o actualizar a una versión específica del tiempo de ejecución de Dapr. Puede encontrar la lista de versiones en Dapr Release .

# Install v1.0.0 runtime
$ dapr init --runtime-version 1.0.0

# Check the versions of CLI and runtime
$ dapr --version
CLI version: v1.0.0
Runtime version: v1.0.0

= " Instalar en una red Docker específica | Instalar en una red Docker específica

Puede instalar el tiempo de ejecución de Dapr en una red Docker específica para aislarlo de la máquina local (por ejemplo, use Dapr desde un contenedor Docker).

# Create Docker network
$ docker network create dapr-network

# Install Dapr to the network
$ dapr init --network dapr-network

Nota: Al instalar en una red Docker específica, debe agregar el parámetro --placement-host-address a dapr para ejecutar comandos en cualquier contenedor dentro de esa red.

2.3.2 Hospedaje en modo Kubenetes

El comando init instalará Dapr en un clúster de Kubernetes. Para casos de uso más avanzados, utilice nuestro gráfico de Helm .

El comando Init instalará Dapr en el clúster de Kubernetes.

Nota: el espacio de nombres predeterminado es dapr-system. La instalación aparecerá bajo el nombre dapr de Helm.

Nota: el espacio de nombres predeterminado es dapr-system. La instalación aparecerá con el nombre dapr Helm

dapr init -k

提供 Valores de timón | Suministro de valores de Helm

# 可以使用 --set 标志设置所有可用的 Helm values | All available Helm Chart values can be set by using the --set flag:
$ dapr init -k --set global.tag=1.0.0 --set dapr_operator.logLevel=error  

# 安装到自定义命名空间 | Installing to a custom namespace
$ dapr init -k -n my-namespace

# 安装时使用高可用的控制平面配置 | Installing with a highly avaialable control plane config 
$ dapr init -k --enable-ha=true

# 安装时禁用 mTLS | Installing with mTLS disabled 
$ dapr init -k --enable-mtls=false

Actualización de Dapr en k8s | Actualización de Dapr en Kubernetes

Para realizar una actualización sin tiempo de inactividad del plano de control de Dapr:

# dapr 升级指定 runtime 版本
$ dapr upgrade -k --runtime-version=1.0.0

Nota: no use el dapr upgrade comando si está actualizando desde las versiones 0.x de Dapr

Nota: si está actualizando desde la versión 0.x de Dapr, no utilice el comando de actualización de Dapr

# 可以使用 --set 标志设置所有可用的 Helm values | All available Helm Chart values can be set by using the --set flag:
$ dapr upgrade -k --runtime-version=1.0.0 --set global.tag=my-tag --set dapr_operator.logLevel=error

3 Desinstalar el entorno Dapr

3.1 Desinstalación del modo autohospedado del host local (autohospedado)

Desinstalar Dapr en modo independiente | Desinstalar Dapr en modo independiente

La desinstalación eliminará el binario daprd y el contenedor de ubicación (si está instalado con Docker o el binario de ubicación si no).

La desinstalación eliminará el binario daprd y el contenedor de diseño (si Docker o el binario de diseño están instalados, en caso contrario).

$ dapr uninstall

Para los usuarios de Linux, si ejecuta su docker cmds con sudo, debe usar " sudo dapr uninstall " para eliminar los contenedores.

Para los usuarios de Linux, si usa sudo para ejecutar los cmds de la ventana acoplable, debe usar "sudo dapr uninstall" para eliminar el contenedor.

El comando anterior no eliminará los contenedores redis o zipkin de forma predeterminada en caso de que lo esté usando para otros fines. Tampoco eliminará la carpeta dapr predeterminada que se creó en dapr init. Para eliminar todos los contenedores (ubicación, redis, zipkin) y también la carpeta dapr predeterminada creada al ejecutar init:

El comando anterior no eliminará el contenedor redis o zipkin de forma predeterminada, en caso de que lo use para otros fines. Tampoco elimina la carpeta dapr predeterminada creada en dapr init. Para eliminar todos los contenedores (ubicación, redis, zipkin) y la carpeta dapr predeterminada creada en init, ejecute:

$ dapr uninstall --all

El comando anterior también se puede ejecutar cuando Dapr se ha instalado en un entorno no acoplable, solo eliminará los binarios instalados y la carpeta dapr predeterminada en ese caso.

Cuando Dapr está instalado en un entorno no acoplable, también puede ejecutar el comando anterior. En este caso, solo eliminará los archivos binarios instalados y la carpeta Dapr predeterminada.

NB: El dapr uninstall comando siempre intentará eliminar el binario / servicio de ubicación y arrojará un error que no puede.

Nota: El comando de desinstalación de dapr siempre intentará eliminar el binario / servicio de ubicación y arrojará un error que no se puede ejecutar.

Siempre debe ejecutar un dapr uninstall antes de ejecutar otro dapr init.

Antes de ejecutar otro dapr init, siempre se debe ejecutar la desinstalación de dapr.

Desinstalar Dapr de una red Docker específica | Desinstalar Dapr de una red Docker específica

Si se instaló previamente en una red Docker específica, Dapr se puede desinstalar con el --network argumento:

Si se instaló previamente en una red Docker específica, Dapr se puede desinstalar a través del parámetro -network:

$ dapr uninstall --network dapr-network

3.2 Desinstalación del modo Hosting en Kubenetes

Desinstalar Dapr en Kubernetes | Desinstalar Dapr en Kubernetes

Para eliminar Dapr de su clúster de Kubernetes, use el uninstall comando con --kubernetes bandera o la -k abreviatura.

Para eliminar Dapr de su clúster de Kubernetes, puede usar el comando de desinstalación: el indicador de Kubernetes o la abreviatura de -k.

dapr uninstall --kubernetes //卸载Kubernetes中的测试环境
helm uninstall dapr -n dapr-system //卸载Kubernetes中的生产环境

En este punto, se han configurado los entornos de desarrollo, pruebas y producción de Dapr, y el siguiente paso es ingresar a la etapa de desarrollo.

Materiales de referencia:

[Sitio web oficial de Dapr] https://dapr.io/
【Dapr cli】https://github.com/dapr/cli
[Serie 1 de desarrollo de aplicaciones de microservicio Dapr: Configuración del entorno] https://www.cnblogs.com/redmoon/p/13576552.html