Trabajo local
El Hub de Código puede utilizarse íntegramente desde la línea de comandos utilizando la CLI si prefieres utilizar tus propias herramientas para trabajar localmente.
Para desplegar una aplicación directamente desde el navegador sin herramientas locales, consulte nuestra guía sobre trabajar en la nube.
Instalación de la CLI
Code Hub puede utilizarse íntegramente desde la línea de comandos; vcr es la interfaz de línea de comandos necesaria para gestionar y desplegar sus aplicaciones desde el terminal.
Configurar la CLI
Configura tu Account con este comando:
El comando te pedirá una región predeterminada, así como tu clave y secreto de API de Vonage, que puedes obtener desde el Panel de API.
Archivo de configuración CLI
vcr configure escribe tus credenciales y preferencias en ~/.vcr-cli. También puedes editar este archivo directamente. El archivo utiliza el formato INI:
El graphql_endpoint para cada región es:
| Región | Punto final |
|---|---|
UE Oeste (aws.euw1) | https://api-eu.vonage.com/v1/vcr/euw1/api/graphql/v1/graphql |
Costa Este de EE. UU. (aws.use1) | https://api-us.vonage.com/v1/vcr/use1/api/graphql/v1/graphql |
AP Sudeste (aws.apse1) | https://api-ap.vonage.com/v1/vcr/apse1/api/graphql/v1/graphql |
AP Sureste de Sydney (aws.apse2) | https://api-ap.vonage.com/v1/vcr/apse2/api/graphql/v1/graphql |
Actualización de la CLI
Para actualizar la ejecución de la CLI:
Esto imprimirá la versión actual de la CLI que ha instalado. Si hay una versión más reciente disponible, se le pedirá que la instale.
NOTA: Es posible que tenga que ejecutar el comando utilizando sudo para dar a Cloud Runtime CLI permisos para mover la nueva versión CLI a la carpeta de instalación. También puede realizar el traslado usted mismo.
Uso de la CLI
Para iniciar un proyecto, ejecuta el siguiente comando y empieza a introducir tus datos:
Al ejecutar el comando se le pedirá la siguiente información:
- Nombre del proyecto: un nombre para tu proyecto.
- Nombre de la instancia: Introduzca un nombre para la instancia que se creará. Puede tener varias instancias para un mismo proyecto, por lo que debe ser memorable.
- Duración: Selecciona el entorno de ejecución que deseas utilizar cuando se ejecute el código.
- Región: Selecciona la región en la que quieres que se ejecute tu instancia.
- ID de aplicación para la instancia: Para usar las API de Vonage, se requiere una Applications. Selecciona el ID de la aplicación que deseas usar; si aún no has creado una, puedes omitir este paso e ingresar el ID más tarde. Para crear una aplicación, ve a la sección Página de Applications en el panel de control de Vonage o ejecuta
vcr app create. Cuando implementes tu instancia, Cloud Runtime configurará automáticamente los webhooks de tu aplicación por ti. - ID de aplicación para depuración: Puede proporcionar un ID de Aplicación independiente que se utilizará únicamente para la depuración, lo que significa que su instancia desplegada y la Aplicación y webhooks correspondientes no se verán afectados por la depuración local.
- Plantilla: Elija una plantilla de la lista para ver un proyecto existente. Encontrará una lista completa de plantillas en la sección Code Hub
Una vez que hayas introducido toda la información necesaria, un vcr.yml donde podrá añadir todo lo que haya omitido o editar cualquiera de los detalles que acaba de proporcionar. Si ha seleccionado una plantilla, también se descargarán los archivos necesarios para ejecutar esa aplicación. Ahora puedes abrir esos archivos en tu configuración local para empezar a ver y editar el proyecto.
Próximos pasos
Mientras trabajas en tu proyecto, es posible que te resulten útiles los siguientes recursos:
- Depuración: Depura tu código localmente como si estuviera desplegado en la plataforma.
- Implementación: Cuando su proyecto esté listo, cree rápidamente una instancia en ejecución en la plataforma mediante el despliegue.
Gestión de Applications
Puedes gestionar las aplicaciones de Vonage desde la CLI utilizando el vcr app comandos.
Para crear una nueva aplicación:
Para regenerar la clave privada y la clave pública de una aplicación existente:
Esto sustituye al par de claves existente de la aplicación. La nueva clave privada se descargará y tendrás que actualizar cualquier referencia a ella en tu proyecto o secretos.