Conéctese a un servicio de espacio de trabajo configurado

Utilice Altifigence CLI 0.1.9 en Linux para trabajar con un servicio existente de espacio de trabajo de Digital Design Studio. Su operador proporciona el origen del servicio, el acceso al espacio de trabajo y las funciones habilitadas. Las solicitudes se dirigen a los archivos y experimentos del espacio de trabajo de ese servicio.

Exija un estado de salida 0 antes de leer un resultado guardado. Conserve la salida de error estándar por separado e inspeccione los campos del resultado descritos a continuación.

Configure la conexión

Establezca ALTI_STUDIO_ENDPOINT en el origen proporcionado por el operador. Los servicios remotos utilizan HTTPS; los servicios en una dirección IP de bucle local pueden utilizar HTTP. Proporcione un origen con una ruta vacía y configure el ALTI_STUDIO_SERVICE_SECRET proporcionado por el operador cuando la autenticación esté habilitada. La CLI envía este valor como x-service-secret. Cada comando también puede seleccionar su origen con --endpoint.

Inspeccione experimentos y archivos conservados

Con la conexión configurada, enumere hasta cinco experimentos. Un espacio de trabajo vacío devuelve el comprobante ilustrativo siguiente; HTTP 200 finaliza con código 0.

alti --json ide service evolve list --limit 5

{"schema":"altifigence.dds.service-receipt.v1","operation":"evolve.list","ok":true,"httpStatus":200,"body":{"runs":[]}}

Para un resultado conservado, utilice su ruta exacta en el espacio de trabajo del servicio. Sustituya la ruta de este ejemplo por la de un archivo que exista en su espacio de trabajo autorizado. El cuerpo de la respuesta conserva los campos del archivo del propietario, incluido content.

alti --json ide service evolve read-file evolve/adder/results/report.md

Busque y reemplace en un archivo revisado

La búsqueda de texto en el espacio de trabajo requiere un servicio en Linux. Busque en el mismo servicio que utilizará para el reemplazo y después revise el archivo coincidente, las ubicaciones y los metadatos de cobertura. Cada coincidencia incluye un contentHash. La CLI conserva truncated y replaceScopeComplete para que usted pueda evaluar el alcance devuelto.

alti --json ide service workspace search --query old_signal --match-case --whole-word

Guarde lo siguiente como replace.json, sustituyendo el hash ilustrativo de 64 caracteres por el contentHash real de la coincidencia seleccionada de rtl/top.sv. Mantenga la consulta y las opciones coherentes con su revisión. La solicitud se dirige a un solo archivo; si se omite match, el reemplazo se aplica a sus ocurrencias coincidentes. El hash esperado vincula la actualización a la versión del archivo que usted revisó.

{
  "query": "old_signal",
  "replacement": "new_signal",
  "options": {
    "matchCase": true,
    "wholeWord": true
  },
  "paths": [
    "rtl/top.sv"
  ],
  "expectedHashes": {
    "rtl/top.sv": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

alti --json ide service workspace replace --request replace.json

Recupérese de conflictos y errores de configuración

Si el archivo ha cambiado, se muestra a continuación un comprobante ilustrativo de conflicto. HTTP 409 finaliza con código 1. Ejecute de nuevo la búsqueda en el mismo servicio, revise las coincidencias y la versión actual del archivo, y después actualice expectedHashes con el contentHash reciente antes de enviar un nuevo reemplazo.

{"schema":"altifigence.dds.service-receipt.v1","operation":"workspace.replace","ok":false,"httpStatus":409,"body":{"ok":false,"code":"search_replace_conflict","conflicts":[{"path":"rtl/top.sv","expectedHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","actualHash":"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"}],"replacements":0,"files":[]}}

STUDIO_ENDPOINT_REQUIRED con httpStatus: null finaliza con código 2: configure el origen del operador y vuelva a ejecutar el comando. Para HTTP 401, obtenga del operador el secreto correspondiente al servicio. Si se agota el tiempo de espera después de un reemplazo, inspeccione el archivo actual y vuelva a buscar antes de decidir si realiza otra actualización.