Aprenda qué es un ID de proyecto, por qué es importante y cómo puede usarlo de manera efectiva para interactuar con sus proyectos a través de la interfaz de línea de comandos (CLI).
Tabla de contenidos
- ¿Qué es un ID de proyecto?
- Diferencia entre el nombre del proyecto y el ID del proyecto
- ¿Por qué usar ID de proyecto?
- Uso de ID de proyecto en comandos de CLI
- Prácticas recomendadas para administrar los ID de proyecto
- Solución de problemas comunes
- Glosario de términos
¿Qué es un ID de proyecto?
Un Project ID es un identificador único e inmutable asignado a cada proyecto al momento de su creación. A diferencia de los nombres de proyecto, que se pueden cambiar o duplicar en los espacios de nombres, el ID de proyecto está garantizado para ser único y persistente.
Piense en el ID del proyecto como la huella digital del proyecto, una forma de identificar e interactuar de manera confiable con el proyecto de manera programática.
Diferencia entre el nombre del proyecto y el ID del proyecto
| Aspecto | Nombre del proyecto | ID del proyecto |
|---|---|---|
| Unicidad | Único por espacio de nombres | Único a nivel mundial |
| Mutabilidad | Puede ser cambiado | Immutable |
| Amigable con el ser humano | Sí, generalmente legible | Normalmente un UUID o hash |
| Uso | Visualización, URLs | Llamadas API, comandos CLI |
¿Por qué usar ID de proyecto?
- Fiabilidad: Evitar la ambigüedad al hacer referencia a los proyectos, especialmente si los nombres cambian.
- Automatización: Los scripts y las canalizaciones de CI/CD pueden usar ID de proyecto para interactuar de forma coherente.
- Seguridad: Los ID de proyecto pueden ser más difíciles de adivinar, lo que reduce el acceso accidental o no autorizado.
- Integración: Las API y las herramientas de terceros a menudo requieren ID de proyecto para acciones precisas.
Uso de ID de proyecto en comandos de CLI
Cuando se utiliza la CLI para administrar proyectos, normalmente es necesario hacer referencia a su proyecto por su ID. Estos son algunos ejemplos comunes:
# List all projects to find the ID
cli-tool projects list
# Get detailed info about a project
cli-tool projects get --id <project-id>
# Deploy a build to a project using its ID
cli-tool deploy --project-id <project-id> --env production
# Delete a project by its ID
cli-tool projects delete --id <project-id>
