Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Ecco alcuni concetti da conoscere quando lavori con i repository dei CodeCatalyst sorgenti.
Argomenti
Progetti
Un progetto rappresenta uno sforzo collaborativo CodeCatalyst che supporta i team e le attività di sviluppo. Dopo aver creato un progetto, puoi aggiungere, aggiornare o rimuovere utenti e risorse, personalizzare la dashboard del progetto e monitorare lo stato di avanzamento del lavoro del team. Puoi avere più progetti all'interno di uno spazio.
Gli archivi di origine sono specifici per i progetti in cui li crei o li colleghi in uno spazio. Non puoi condividere un repository tra progetti e non puoi collegare un repository a più di un progetto in uno spazio. Gli utenti con il ruolo di collaboratore o amministratore di progetto in un progetto possono interagire con gli archivi di origine associati a quel progetto in base alle autorizzazioni concesse a tali ruoli. Per ulteriori informazioni, consulta Concessione dell'accesso con ruoli utente.
Archivi di origine
Un repository di sorgenti consente di archiviare in modo sicuro codice e file per il progetto. Memorizza anche la cronologia delle versioni dei file. Per impostazione predefinita, un archivio dei sorgenti viene condiviso con gli altri utenti del CodeCatalyst progetto. È possibile disporre di più di un archivio di sorgenti per un progetto. È possibile creare archivi di sorgenti per progetti in CodeCatalyst oppure scegliere di collegare un archivio di sorgenti esistente ospitato da un altro servizio se tale servizio è supportato da un'estensione installata. Ad esempio, è possibile collegare un GitHub repository a un progetto dopo aver installato l'GitHub estensione Repositories. Per ulteriori informazioni, consulta Memorizzazione del codice sorgente nei repository per un progetto in CodeCatalyst e Guida rapida: installazione di estensioni, connessione di provider e collegamento di risorse in CodeCatalyst.
Ambienti di sviluppo
Un ambiente di sviluppo è un ambiente di sviluppo basato su cloud che puoi utilizzare CodeCatalyst per lavorare rapidamente sul codice archiviato nei repository di origine del tuo progetto. Gli strumenti di progetto e le librerie di applicazioni inclusi nel tuo ambiente di sviluppo sono definiti da un devfile nel repository di origine del progetto. Se non avete un devfile nel vostro repository di origine, verrà applicato automaticamente un devfile predefinito. Il devfile predefinito include strumenti per i linguaggi e i framework di programmazione più utilizzati. Per impostazione predefinita, un ambiente di sviluppo è configurato per avere un processore a 2 core, 4 GB di RAM e 16 GiB di storage persistente.
Puoi scegliere di clonare un ramo esistente del tuo repository di origine nel tuo ambiente di sviluppo oppure puoi scegliere di creare un nuovo ramo come parte della creazione dell'ambiente di sviluppo.
Token di accesso personali () PATs
Un token di accesso personale (PAT) è simile a una password. È associato all'identità utente e può essere utilizzato in tutti gli spazi e i progetti di CodeCatalyst. Si utilizza PATs per accedere a CodeCatalyst risorse che includono ambienti di sviluppo integrati (IDEs) e repository di sorgenti basati su Git. PATs ti rappresentano CodeCatalyst e puoi gestirle nelle tue impostazioni utente. Un utente può avere più di un PAT. I token di accesso personali vengono visualizzati solo una volta. Come procedura consigliata, assicurati di archiviarli in modo sicuro sul tuo computer locale. Per impostazione predefinita, PATs scadono dopo un anno.
Quando si lavora con ambienti di sviluppo integrati (IDEs), PATs sono l'equivalente di una password Git. Fornisci il PAT quando ti viene richiesta una password quando configuri il tuo IDE per funzionare con un repository Git. Per ulteriori informazioni su come connettere il tuo IDE con un repository basato su Git, consulta la documentazione del tuo IDE.
Rami
Un ramo è un puntatore o un riferimento a un commit in Git e in CodeCatalyst. Puoi usare le filiali per organizzare il tuo lavoro. Ad esempio, puoi utilizzare i rami per lavorare su una versione nuova o diversa dei file senza influire sui file in altri rami. Puoi utilizzare i rami per sviluppare nuove funzionalità, archiviare una versione specifica del tuo progetto e altro ancora. Un repository di origine può avere uno o più rami. Quando si crea un progetto utilizzando un modello, il repository di origine creato per il progetto contiene file di esempio in un ramo chiamato main. Il ramo principale è il ramo predefinito per il repository.
Rami predefiniti
I repository di origine CodeCatalyst hanno un ramo predefinito indipendentemente da come li crei. Se scegliete di creare un progetto utilizzando un modello, l'archivio di origine creato per quel progetto include un file README.md oltre a codice di esempio, definizioni del flusso di lavoro e altre risorse. Se si crea un repository di origine senza utilizzare un modello, viene aggiunto automaticamente un file README.md come primo commit e viene creato automaticamente un ramo predefinito come parte della creazione del repository. Questo ramo predefinito è denominato main. Questo ramo predefinito è quello utilizzato come ramo di base o predefinito nei repository locali (repos) quando gli utenti clonano il repository. È possibile modificare il ramo utilizzato come ramo predefinito. Per ulteriori informazioni, consulta Gestione del ramo predefinito per un repository.
Non è possibile eliminare il ramo predefinito per un repository di origine. I risultati della ricerca includono solo i risultati del ramo predefinito.
Commit
Un commit è una modifica a un file o a un set di file. Nella CodeCatalyst console Amazon, un commit salva le modifiche e le invia a un repository di origine. Il commit include informazioni sulla modifica, tra cui l'identità dell'utente che ha apportato la modifica, l'ora e la data della modifica, il titolo del commit e qualsiasi messaggio incluso sulla modifica. Per ulteriori informazioni, consulta Comprendere le modifiche al codice sorgente con i commit in Amazon CodeCatalyst.
Nel contesto di un repository di origine in CodeCatalyst, i commit sono istantanee del contenuto e delle modifiche apportate al contenuto del repository. Puoi anche aggiungere tag Git ai commit, per identificare commit specifici.
Richieste pull
Una pull request è il modo principale con cui tu e gli altri utenti esaminate, commentate e unite le modifiche al codice da un ramo all'altro in un repository di origine. È possibile utilizzare le richieste pull per esaminare in modo collaborativo le modifiche al codice in caso di modifiche o correzioni minori, aggiunte di funzionalità importanti o nuove versioni del software rilasciato. In una pull request, puoi esaminare le modifiche tra i rami di origine e di destinazione o le differenze tra le revisioni di tali rami. È possibile aggiungere commenti alle singole righe di modifiche al codice e commenti sulla pull request in generale.
Suggerimento
Durante la creazione di una pull request, la differenza visualizzata è la differenza tra la punta del ramo di origine e la punta del ramo di destinazione. Una volta creata la pull request, la differenza visualizzata sarà tra la revisione della pull request scelta e il commit che costituiva la punta del ramo di destinazione quando è stata creata la pull request. Per ulteriori informazioni sulle differenze e sulle basi di unione in Git, consulta git-merge-base
Revisioni
Una revisione è una versione aggiornata di una pull request. Ogni push al ramo sorgente di una pull request crea una revisione che contiene le modifiche apportate nei commit inclusi in quel push. È possibile visualizzare le differenze tra le revisioni di una pull request oltre alle differenze tra i rami di origine e di destinazione. Per ulteriori informazioni, consulta Revisione del codice con richieste pull in Amazon CodeCatalyst.
Flussi di lavoro
Un flusso di lavoro è una procedura automatizzata che descrive come creare, testare e distribuire il codice come parte di un sistema di integrazione e distribuzione continua (CI/CD). Un flusso di lavoro definisce una serie di passaggi, o azioni, da eseguire durante l'esecuzione di un flusso di lavoro. Un flusso di lavoro definisce anche gli eventi, o trigger, che causano l'avvio del flusso di lavoro. Per configurare un flusso di lavoro, è necessario creare un file di definizione del flusso di lavoro utilizzando l'editor visivo o YAML della CodeCatalyst console.
Suggerimento
Per una rapida occhiata a come potresti utilizzare i flussi di lavoro in un progetto, crea un progetto con un blueprint. Ogni blueprint implementa un flusso di lavoro funzionante che puoi rivedere, eseguire e sperimentare.
Un repository di origine può anche archiviare i file di configurazione e altre informazioni per flussi di lavoro, notifiche, problemi e altre informazioni di configurazione per il progetto. I file di configurazione vengono creati e archiviati nell'archivio di origine quando si creano risorse che richiedono file di configurazione o quando si specifica il repository come azione di origine per un flusso di lavoro. Se create un progetto da un blueprint, i file di configurazione saranno già archiviati nel repository di origine creato per voi come parte del progetto. Queste informazioni di configurazione sono memorizzate in una cartella denominata .codecatalyst nel ramo predefinito del repository. Ogni volta che crei un ramo del ramo predefinito, crei una copia di questa cartella e della sua configurazione oltre a tutti gli altri file e cartelle del ramo.
