Connettersi a un servizio di area di lavoro configurato

Utilizza Altifigence CLI 0.1.9 su Linux per lavorare con un servizio di area di lavoro Digital Design Studio esistente. L'operatore fornisce l'origine del servizio, l'accesso all'area di lavoro e le funzionalità abilitate. Le richieste si rivolgono ai file dell'area di lavoro e agli esperimenti di quel servizio.

Verifica che lo stato di uscita sia 0 prima di leggere un risultato salvato. Conserva separatamente l'output di errore standard e ispeziona i campi del risultato descritti di seguito.

Configurare la connessione

Imposta ALTI_STUDIO_ENDPOINT sull'origine fornita dall'operatore. I servizi remoti utilizzano HTTPS; i servizi su IP di loopback possono utilizzare HTTP. Fornisci un'origine con percorso vuoto e configura ALTI_STUDIO_SERVICE_SECRET, fornito dall'operatore, quando l'autenticazione è abilitata. La CLI invia questo valore come x-service-secret. Ogni comando può anche selezionare la propria origine con --endpoint.

Ispezionare esperimenti e file conservati

Con la connessione configurata, elenca fino a cinque esperimenti. Un'area di lavoro vuota restituisce la ricevuta illustrativa seguente; HTTP 200 termina con codice 0.

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

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

Per un risultato conservato, utilizza il percorso esatto nell'area di lavoro del servizio. Sostituisci questo percorso di esempio con un file presente nell'area di lavoro a cui hai accesso autorizzato. Il corpo della risposta conserva i campi del file del proprietario, incluso content.

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

Cercare e sostituire in un solo file verificato

La ricerca di testo nell'area di lavoro richiede un servizio Linux. Esegui la ricerca sullo stesso servizio che utilizzerai per la sostituzione, quindi verifica il file corrispondente, le posizioni e i metadati di copertura. Ogni corrispondenza contiene un contentHash. La CLI conserva truncated e replaceScopeComplete per consentirti di valutare l'ambito restituito.

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

Salva quanto segue come replace.json, sostituendo l'hash illustrativo di 64 caratteri con il contentHash effettivo della corrispondenza selezionata in rtl/top.sv. Mantieni la query e le opzioni coerenti con la verifica che hai effettuato. La richiesta riguarda un solo file; omettendo match, la sostituzione viene applicata alle occorrenze corrispondenti al suo interno. L'hash atteso vincola l'aggiornamento alla versione del file che hai verificato.

{
  "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

Risolvere conflitti ed errori di configurazione

Se il file è cambiato, viene restituita una ricevuta di conflitto come quella illustrata di seguito. HTTP 409 termina con codice 1. Ripeti la ricerca sullo stesso servizio, verifica le corrispondenze e la versione corrente del file, quindi aggiorna expectedHashes con il nuovo contentHash prima di inviare una nuova sostituzione.

{"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 termina con codice 2: configura l'origine dell'operatore e ripeti il comando. Per HTTP 401, ottieni dall'operatore il segreto del servizio corrispondente. Se si verifica un timeout dopo la sostituzione, ispeziona il file corrente e ripeti la ricerca prima di decidere se effettuare un altro aggiornamento.