Configurar las herramientas de Salesforce DX
Objetivos de aprendizaje
- Describir en qué se diferencia el modelo para el desarrollo tradicional de organizaciones del desarrollo modular de paquetes.
- Describir las caracterÃsticas principales de un paquete.
Primeros pasos con el desarrollo basado en el código fuente
Salesforce DX ofrece herramientas que simplifican todo el ciclo de vida de desarrollo. Permite mejorar el desarrollo y la colaboración en equipo, facilita las pruebas automáticas y la integración continua, y hace que el ciclo de publicación sea más eficiente y ágil.
Sin embargo, Salesforce DX es mucho más que un conjunto de herramientas. También proporciona una alternativa al desarrollo de conjuntos de cambios, y permite que la fuente de información pase de ser la organización a su sistema de control de versiones (VCS). Además, cambia el enfoque de desarrollo desde el desarrollo de organizaciones al desarrollo de paquetes. Para saber cómo migrar sus procesos actuales de desarrollo al modelo de desarrollo de paquetes, consulte el módulo Modelo de desarrollo de paquetes.
Pero se acabó la charla. Es hora de empezar a ponernos manos a la obra. Vamos a empezar a preparar el entorno y a presentarle algunas herramientas.
¿Qué es una organización borrador?
Muchas de las herramientas de Salesforce DX permiten usar un tipo de organización llamada organización borrador. Una organización borrador es un entorno de Salesforce temporal, configurable y dedicado. Las organizaciones borrador aumentan la productividad y la colaboración de los desarrolladores durante el proceso de desarrollo, y facilita la posibilidad de hacer pruebas automáticas y disfrutar de una integración continua. Puede usar la CLI o las extensiones de Salesforce para Visual Studio Code para abrir la organización borrador en un navegador sin tener que iniciar sesión. También puede crear una organización borrador cuando quiera para hacer lo siguiente:
- Empezar un proyecto nuevo.
- Empezar una nueva rama con funciones.
- Probar una nueva función.
- Empezar pruebas automatizadas.
- Realizar tareas de desarrollo directamente en una organización.
- Empezar de cero con una organización nueva.
Aunque las organizaciones borrador están pensadas para descartarlas una vez cumplida su misión, sus archivos de configuración contienen toda la chicha. Con el archivo de configuración, puede configurar la organización borrador con distintas ediciones de Salesforce y solo las funciones y los parámetros que quiera. Además, puede compartir el archivo de configuración de la organización borrador con otros miembros del equipo. De esa forma, todos tendrán la misma organización básica en la que realizar las tareas de desarrollo.
¿Las organizaciones borrador sustituyen a los sandboxes?
No, las organizaciones borrador están diseñadas para ser réplicas de los sandboxes o las organizaciones de producción. Puesto que son temporales (duran un máximo de 30 dÃas), las organizaciones borrador son ideales para desarrollar una función nueva, personalizar funciones o empaquetar aplicaciones. Además, funcionan perfectamente para probar unidades y ofrecer integración continua. Los sandboxes, que contienen todos los metadatos de la organización de producción, siguen siendo necesarios para las pruebas finales de aceptación del usuario, la entrega continua y el almacenamiento provisional.
Todo esto está genial. Pero siga leyendo.
Activar Dev Hub
Un entorno Dev Hub permite tanto a usted como a su equipo crear y gestionar organizaciones borrador. Las organizaciones borrador son entornos de Salesforce temporales en los que se hace la gran parte del trabajo de desarrollo con un paradigma de desarrollo basando en el código fuente.
Para empezar con las organizaciones borrador, es necesario elegir una organización que funcione como Dev Hub. Aunque puede activar Dev Hub en cualquier organización de pago, lo mejor siempre es practicar en otro entorno que no sea el de producción. Lo mejor es activar Dev Hub en una organización de Developer Edition o Trailhead Playground para usarlo en este módulo. Verá sus Trailhead Playgrounds actuales o podrá crear uno nuevo. Para ello, haga clic en su fotografÃa de perfil y seleccione Hands-On Orgs (Organizaciones prácticas).
- Inicie sesión en la organización que haya elegido como Dev Hub.
- En Setup (Configuración), escriba
Dev Hub
en el cuadro Quick Find (Búsqueda rápida) y, a continuación, seleccione Dev Hub. - Haga clic en el botón para activar Dev Hub.
También puede convertir cualquier organización de pago en Dev Hub y conceder acceso a los desarrolladores. Todos los detalles están en la GuÃa del desarrollador de Salesforce DX.
Ahora que ya tiene una organización de Dev Hub, vamos a configurar el resto de herramientas de Salesforce DX.
Instalar Salesforce CLI
- Instale la CLI desde https://developer.salesforce.com/tools/salesforcecli.
- Confirme que la CLI esté bien instalada y se ejecute en la versión más reciente. Para ello, ejecute el siguiente comando en la lÃnea de comandos.
El resultado deberÃa ser algo asÃ:@salesforce/cli:Updating CLI...
. A continuación, el comando de actualización muestra las notas de la versión más reciente.
Estos son algunos otros comandos útiles que le ayudarán a comenzar:
Comando | Lo que se ve |
---|---|
sf --help |
Todos los temas disponibles y los comandos de alto nivel. |
sf commands |
Todos los comandos disponibles. |
-h
ofrece información concisa sobre lo que hacen el comando y sus indicadores. El indicador --help
proporciona descripciones y ejemplos detallados. Asà es cómo se pueden ver ambos tipos de ayuda de un comando en cuanto se ejecuta: org login web
.Muchos indicadores de comandos de la CLI tienen un nombre breve y otro largo. Por ejemplo, muchos comandos utilizan --target-org
para especificar una organización. Este indicador tiene un nombre breve: -o
. A modo de aclaración, en este módulo solo aparecen nombres largos de indicadores, pero puede usar los breves si asà lo desea.
Vamos a seguir con la configuración del resto de herramientas de Salesforce DX.
Iniciar sesión en Dev Hub
Para empezar, inicie sesión en Dev Hub desde la CLI para contar con la autorización necesaria para crear organizaciones borrador. Puede usar el comando org login web
para iniciar sesión en distintas organizaciones, y hay opciones para administrar dichas organizaciones.
-
Para autorizar el entorno de Dev Hub, utilice el siguiente flujo de inicio de sesión web:Si especifica el indicador
--set-default-dev-hub
, esta organización será el Dev Hub predeterminado. Utilice el indicador--alias
para definir un alias para la organización (algo fácil de recordar como DevHub). Un alias es mucho más fácil de recordar que el nombre de usuario único del Dev Hub.
Importante: Use únicamente el indicador--set-default-dev-hub
para su Dev Hub. Si lo utiliza con otra organización, no podrá crear organizaciones borrador hasta que identifique el Dev Hub con el comandoconfig set
. - Inicie sesión con sus credenciales en la ventana del navegador que se abre.
Cuando acabe, la CLI guardará de forma segura el token junto con el alias de la organización, en este caso, DevHub. Puede cerrar la ventana del navegador de la organización de Dev Hub cuando quiera.
Puede cerrar Dev Hub y crear organizaciones borrador igualmente. Sin embargo, si quiere abrir la organización de Dev Hub para ver las organizaciones borrador activas o su registro de espacio de nombres, el alias resulta muy práctico:
Más información sobre la gestión de organizaciones
Es posible que tenga muchas organizaciones, incluidos sandboxes y la organización de producción. Desde la CLI, también puede iniciar sesión en ellas con estos comandos. Cuando inicia sesión en una organización desde la CLI, la agrega a la lista de organizaciones con las que puede trabajar la CLI en el futuro.
Iniciar sesión en los sandboxes
Si crea un alias para el sandbox (indicador --alias
), puede hacer referencia al mismo con el alias en lugar de con el nombre de usuario, que es largo y suele ser poco intuitivo.
Por ejemplo:
Si no conoce la URL de inicio de sesión de su organización, puede encontrarla en la página My Domain Setup (Configuración de mi dominio).
El poder de los alias
Como puede imaginarse, los alias son una forma muy potente de gestionar y controlar las organizaciones, y los consideramos una práctica recomendada. ¿Por qué? Veamos los nombres de usuario de las organizaciones borrador a modo de ejemplo. El nombre de usuario de una organización borrador es algo parecido a esto: test-7emx29rtpx0y@example.com
. No es fácil de recordar. Asà que cuando envÃa un comando que requiere el nombre de usuario de la organización, el hecho de usar un alias que pueda recordar fácilmente puede acelerar el proceso.
Ver todas las organizaciones
Cuando quiera, puede ejecutar el comando sf org list
para ver todas las organizaciones en las que ha iniciado sesión. Si agrega el indicador --all
, verá incluso más información, como las organizaciones borrador que se han eliminado recientemente.
Ya está listo para seguir avanzando, asà que vamos a desarrollar una aplicación nueva con Salesforce CLI y las organizaciones borrador.
Recursos
- Documentación de Salesforce: GuÃa de configuración de Salesforce CLI
- Documentación de Salesforce: Referencia de comandos de Salesforce CLI
- Documentación de Salesforce: GuÃa del desarrollador de Salesforce DX
- Visual Studio Marketplace: Salesforce Extensions for VS Code (Visual Studio Marketplace: extensiones de Salesforce para Visual Studio Code)