Esta es una traducción que desde EGA Futura ofrecemos como cortesía a toda la Ohana y comunidad de programadores , consultores , administradores y arquitectos de Salesforce para toda Iberoamérica .
El enlace a la publicación original, lo encontrarás al final de este artículo.
…
Como parte de la unificación de la CLI de Salesforce , agrupamos dos ejecutables: sfdx y sf . El ejecutable sf eventualmente proporcionará un conjunto único de comandos diseñados para desarrollar e implementar aplicaciones en todas las nubes de Salesforce. Actualmente, es compatible con la plataforma de Salesforce y las funciones de Salesforce. Algunos de los comandos sf son completamente interoperables con su equivalente sfdx .
Para los comandos sfdx que tienen su equivalente sf , lo alentamos a probar los comandos sf en su flujo de trabajo de desarrollador por dos razones principales:
- Los comandos
sfson fáciles de usar y, opcionalmente, pueden ser interactivos. Los comandos interactivos le solicitan activamente la información requerida en lugar de aceptar pasivamente los valores de los indicadores, lo que reduce los errores. - Algunos de los comandos
sfson mucho más eficientes y tienen funciones mejoradas en comparación con su equivalentesfdx.
En esta publicación de blog, exploraremos uno de esos comandos, sf env create scratch (actualmente en Beta), que se utiliza para administrar la creación de organizaciones temporales. Verá por qué sf env create scratch es mucho mejor que su comando sfdx equivalente, sfdx force:org:create .
Pero primero, repasemos la serie de pasos necesarios para ejecutar sfdx force:org:create .
¿Cómo funciona el comando de creación de organizaciones SFDX?
Cuando ejecuta el sfdx force:org:create , las siguientes tareas se realizan en el orden que se indica a continuación
- En primer lugar, la CLI crea el cuerpo de solicitud necesario para la creación de la organización borrador, lo que implica transformar el archivo de definición de la organización borrador
- A continuación, la CLI realiza una solicitud HTTPS POST a la organización de Dev Hub para iniciar el proceso de creación de la organización borrador.
- A continuación, la CLI continúa sondeando para ver si la creación de la organización borrador se realizó correctamente.
- Tras la creación de la organización, la CLI se autentica en la organización y guardamos la información de autorización y las configuraciones (como el nombre de usuario y el alias)
- A continuación, la CLI implementa la configuración en la organización temporal especificada en la propiedad de configuración del archivo de definición temporal.
- Finalmente, la CLI restablece el seguimiento de la fuente a partir del resultado del Paso 5
Los pasos anteriores se pueden visualizar como se muestra en el siguiente diagrama de flujo:
La creación de organizaciones es un proceso asíncrono; a veces, cualquiera de los pasos anteriores puede fallar debido a varios problemas, como fallas en la red, fallas en mdapi o tiempos de espera. También hay varios tipos de organizaciones borrador, como las organizaciones creadas con las funciones de formas de organizaciones e instantáneas de organizaciones, que pueden tardar mucho tiempo en crearse y pueden producir un tiempo de espera.
Analicemos un par de escenarios de error que pueden ocurrir, junto con su impacto.
Escenario de error A: interrupción de la red
Imaginemos que durante el proceso de creación de una organización borrador entre el Paso 2 y el Paso 3 en el diagrama anterior, hubo una interrupción de la red. En este caso, la organización se crea en su Dev Hub pero no puede conectarse a ella. Las organizaciones temporales huérfanas aún cuentan para su límite de organizaciones temporales asignadas.
En este caso, su única opción es eliminar la organización borrador manualmente buscándola en su Dev Hub .
Escenario de error B: error de implementación/tiempos de espera cuando la plataforma está ocupada
Es posible que observe que, a veces, las implementaciones de metadatos se atascan en estado pendiente cuando la plataforma está muy ocupada y es posible que se agote el tiempo de espera. Esto puede suceder durante el Paso 5 que se muestra en el diagrama anterior.
Nuevamente, en este caso, su única opción es eliminar la organización borrador buscándola en su Dev Hub .
Presentamos los comandos sf env create scratch /sandbox
Con el nuevo comando sf env create scratch , hemos agregado nuevas funciones, que incluyen:
- Un indicador visual que muestra el progreso a lo largo del proceso de creación.
- Un ID de trabajo que está vinculado con el trabajo de creación de la organización.
- Guardamos la información de la organización borrador, por lo que los trabajos fallidos se pueden reanudar si es necesario
Veamos un comando de muestra para la creación de una organización borrador:
sf env create scratch --target-dev-hub=MyHub --definition-file config/project-scratch-def.json --set-default --duration-days 3 --async
En el comando anterior, especificamos Dev Hub usando su alias y un archivo de definición de organización borrador. Establecemos la organización borrador como nuestra predeterminada y especificamos que caduca en tres días.
También tenga en cuenta que al final del comando, hemos usado un indicador --async . Con --async , la creación de la organización temporal se realiza de forma asíncrona.
Ya sea que el comando elimine la creación de la organización de forma síncrona o asíncrona, siempre devuelve una ID de trabajo. Usando esta ID, podemos reanudar la creación de la organización en caso de falla. Para reanudar, use el comando sf env resume como se muestra a continuación.
sf env resume scratch --job-id 2SR3u0000008fBDGAY
Bonificación: si no desea usar la identificación del trabajo, también puede usar el indicador —use-most-recent para reanudar la creación de env para la creación de organización borrador más reciente. El comando con el indicador —use-most-recent se vería de la siguiente manera:
sf env resume scratch--use-most-recent
Ahora, volvamos a los escenarios de error que discutimos anteriormente y veamos cómo usar estos nuevos comandos es más efectivo.
Revisión del escenario de error A: interrupción de la red
Si usa sf env create scratch , el currículum encontrará su organización borrador y autenticación, y finalizará los pasos restantes
Revisión del escenario de error B: falla de implementación/tiempos de espera cuando la plataforma está ocupada
Si usa sf env create scratch , use el comando sf env resume para reanudar la operación.
¿Qué pasa con los areneros?
Para sandboxes, hay un par de comandos en Beta, sf env create sandbox y sf env resume sandbox , que funcionan de manera similar a las operaciones que describimos para las organizaciones temporales.
Pruébelo y envíenos sus comentarios
¡Queremos escuchar de ti! Creamos esta nueva función para ayudarlo a administrar mejor el proceso de creación de la organización borrador/sandbox. Si encuentra problemas al usar este comando o tiene otros tipos de comentarios, registre un problema en el repositorio de GitHub .
Sobre los autores
Shane McLaughlin es ingeniero en el equipo de CLI de Salesforce. Puede seguir a Shane en twitter @mshanemc y explorar sus proyectos de código abierto a través de su cuenta de GitHub @mshanemc.
Mohith Shrivastava es promotor de desarrolladores en Salesforce. Tiene una década de experiencia en la creación de productos a escala empresarial en la plataforma Salesforce. Mohith se encuentra actualmente entre los principales contribuyentes en Salesforce Stack Exchange, un foro de desarrolladores donde los desarrolladores de Salesforce pueden hacer preguntas y compartir conocimientos. Actualmente se está centrando en las herramientas de desarrollo de Salesforce, los servicios de plataforma y los componentes web Lightning en Salesforce. Puedes seguirlo en Twitter @msrivastav13.
…
Esta es una traducción realizada por EGA Futura, y este es el link a la publicación original: https://developer.salesforce.com/blogs/2022/07/better-manage-scratch-org-creation-using-the-env-create-scratch-command-beta.html
