Inicio rápido: Utilizar Salesforce CLI con DevOps Center

Configurar una canalización

Cree una canalización, agregue y configure sus etapas, active la canalización y adjunte su proyecto.

1. Enumere sus proyectos para encontrar el Id. de proyecto.

   sf devops project list --target-org my-devops-org

   Copie el Id. del proyecto que desea adjuntar a las oportunidades en curso. Los ejemplos de este inicio rápido utilizan 0Hn000000000001.

2. Cree una canalización inactiva y conéctela a su repositorio.

   sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo https://github.com/myorg/myrepo

   Copie el Id. de canalización desde la salida del comando. Los ejemplos de este inicio rápido utilizan 0XB000000000001.

   Las oportunidades en curso permanecen inactivas hasta que configure sus etapas y las active.

   Para crear un repositorio mientras crea las oportunidades en curso, utilice --create-repo con --repo-type github|bitbucket.

3. Agregue etapas a sus oportunidades en curso. Una nueva canalización incluye una etapa final predeterminada. Agregue cada nueva etapa antes de una etapa existente especificando esa etapa existente con --next-stage-id.

   Por ejemplo, agregue una etapa Integración.

   sf devops pipeline stage add --target-org my-devops-org --pipeline-id 0XB000000000001 --name "Integration" --next-stage-id 0Xc000000000001

   Copie el Id. de etapa desde la salida del comando. Los ejemplos restantes utilizan 0Xc000000000005 para la etapa de integración. Repita el comando para cada etapa adicional, como UAT.

   

   Sugerencia Visualice sus oportunidades en curso en la interfaz de usuario de DevOps Center para obtener los Id. de etapa para comandos posteriores. O ejecutar sf devops pipeline get --pipeline-id 0XB000000000001.
4. Configure cada etapa. Cada etapa requiere una sucursal y un entorno. Configure las etapas de derecha a izquierda porque la etapa final debe tener una bifurcación antes de poder configurar las etapas anteriores.

   Agregue una bifurcación a la etapa Integración. El indicador de --create-vcs-branch crea la bifurcación en el repositorio si no existe.

   sf devops stage branch add --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000005 --branch-name integration --create-vcs-branch

   Agregue un entorno sandbox a la etapa.

   sf devops stage environment add --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000005 --environment-name Integration_Org --org-type Sandbox

   Se abre una ventana del navegador de modo que pueda autenticarse en el entorno. Utilice --org-type Production para organizaciones de producción. En un entorno desatendido, agregue --no-browser y siga las instrucciones de autenticación devueltas por el comando.

   Repita los comandos de entorno y sucursal para cada etapa. Utilice el nombre de la sucursal, el nombre del entorno y el tipo de organización apropiados para cada etapa.

5. Active las oportunidades en curso.
   

   Importante No puede modificar la etapa de canalización después de promocionar cambios a través de ella. Asegúrese de que todas las etapas están configuradas correctamente antes de ejecutar este comando.

   sf devops pipeline update --target-org my-devops-org --pipeline-id 0XB000000000001 --activate

6. Adjunte su proyecto DevOps Center a las oportunidades en curso.

   sf devops pipeline project add --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001

   Las oportunidades en curso están listas. Cree elementos de trabajo en la interfaz de usuario de DevOps Center o ejecute el comando sf devops work-item create.

Gestionar un elemento de trabajo

Complete un ciclo de desarrollo iniciando un elemento de trabajo, enviando sus cambios, creando una revisión y marcando el elemento de trabajo como listo para promocionar.

1. Establezca el estado del elemento de trabajo como En curso. DevOps Center crea una bifurcación de funciones para el elemento de trabajo.

   sf devops work-item update --target-org my-devops-org --work-item-name WI-000042 --status "In Progress"

2. Obtenga la bifurcación de funciones del repositorio conectado y compruébela en su proyecto local.

   git fetch origin
   git checkout WI-000042

3. Recupere cambios desde su organización de desarrollo. Este ejemplo recupera una clase Apex de la organización con el alias my-sandbox.

   sf project retrieve start --target-org my-sandbox --metadata ApexClass:MyNewClass

4. Revise los archivos recuperados, escénelos, compruébelos y envíe la bifurcación de funciones.

   git status
   git add force-app
   git commit -am "Implement new feature"
   git push origin WI-000042

   Ajuste la ruta que se pasó a git add si su proyecto Salesforce DX utiliza un directorio de paquetes diferente.

5. Cree una solicitud de cambio (solicitud de extracción) para combinar la bifurcación de función en la bifurcación de destino.

   sf devops review create --target-org my-devops-org --work-item-name WI-000042

6. Espere que su equipo apruebe y combine la solicitud de cambio.
7. Actualice el estado del elemento de trabajo para indicar que está listo para la promoción.

   sf devops work-item update --target-org my-devops-org --work-item-name WI-000042 --status "Ready to Promote"

Promocionar un elemento de trabajo

Promocione el elemento de trabajo a la siguiente etapa de canalización. DevOps Center valida la promoción, ejecuta los conjuntos de pruebas configurados para la etapa de destino e implementa los cambios si se superan las pruebas.

1. Promocione el elemento de trabajo utilizando el Id. de elemento de trabajo y el Id. de etapa de destino.

   sf devops promote --target-org my-devops-org --work-item-id 0Wx000000000042 --target-stage-id 0Xc000000000002

   El resultado del comando incluye un Id. de solicitud. Utilícelo para comprobar el estado de la promoción.

   Status: Completed
   Message: Work items successfully promoted to UAT.
   Request ID: a0B000000000001
   
   Promoted Work Items
   ───────────────────
   0Wx000000000042

2. Utilice el Id. de solicitud para comprobar el estado de la promoción.

   sf devops request status --target-org my-devops-org --request-token a0B000000000001

Tareas habituales

Utilice estos comandos durante su flujo de trabajo de desarrollo diario.

1. Promocione múltiples elementos de trabajo en la misma etapa. Especifique --work-item-id una vez para cada elemento de trabajo.

   sf devops promote --target-org my-devops-org --work-item-id 0Wx000000000042 --work-item-id 0Wx000000000043 --target-stage-id 0Xc000000000002

2. Implemente cambios combinados de forma externa en una etapa que no está sincronizada con DevOps Center.

   sf devops promotion complete --target-org my-devops-org --target-stage-id 0Xc000000000002

Casos de uso avanzados

Tras completar el flujo de trabajo básico, utilice estos comandos para promociones que requieren más control.