Configurazione e utilizzo di npm

Per npm utilizzarlo CodeCatalyst, è necessario connettersi npm al repository dei pacchetti e fornire un token di accesso personale (PAT) per l'autenticazione. È possibile visualizzare le istruzioni per la connessione npm al repository dei pacchetti nella CodeCatalyst console.

Indice

• Configurazione di npm con CodeCatalyst
• Installazione dei pacchetti npm da un repository di pacchetti CodeCatalyst
• Installazione dei pacchetti npm da npmjs tramite CodeCatalyst
• Pubblicazione di pacchetti npm nel tuo repository di pacchetti CodeCatalyst
• supporto per i comandi npm
  • Comandi supportati che interagiscono con un archivio di pacchetti
  • Comandi lato client supportati
  • Comandi non supportati

Configurazione di npm con CodeCatalyst

Le seguenti istruzioni spiegano come autenticarsi e connettersi npm al repository dei pacchetti. CodeCatalyst Per ulteriori informazioni su npm, consulta la documentazione ufficiale di npm.

Per connetterti npm al tuo repository di pacchetti CodeCatalyst

1. Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.

2. Vai al tuo progetto.

3. Nel riquadro di navigazione scegliere Pacchetti.

4. Scegli il tuo repository di pacchetti dall'elenco.

5. Scegli Connect to repository.

6. Nei dettagli di configurazione, in Package manager client, scegli npm client.

7. Scegli il tuo sistema operativo per visualizzare i passaggi di configurazione corrispondenti.

8. È necessario un token di accesso personale (PAT) per autenticare npm con. CodeCatalyst Se hai già un token, puoi usarlo. In caso contrario, puoi crearne uno utilizzando i seguenti passaggi.

   1. (Facoltativo): aggiorna il PATnome e la data di scadenza.

   2. Scegli Crea token.

   3. Copia e archivia il tuo PAT in un luogo sicuro.

      avvertimento

      Non potrai PAT più vedere o copiare i tuoi dati dopo aver chiuso la finestra di dialogo. Le credenziali devono essere di breve durata per ridurre al minimo il periodo di tempo in cui un utente malintenzionato può utilizzarle dopo averle sottratte indebitamente.

9. Esegui i seguenti comandi dalla directory principale del tuo progetto per configurare npm con il tuo repository di pacchetti. I comandi eseguiranno le seguenti operazioni:

   • Crea un .npmrc file a livello di progetto se il tuo progetto non ne ha uno.

   • Aggiungi le informazioni sull'endpoint del repository del pacchetto al file a livello di progetto. .npmrc

   • Aggiungi le tue credenziali (PAT) al tuo file a livello utente. .npmrc

   Sostituisci i seguenti valori.

   Nota

   Se state copiando le istruzioni dalla console, i valori dei seguenti comandi vengono aggiornati automaticamente e non è necessario modificarli.

   • Replace (Sostituisci) username con il tuo nome CodeCatalyst utente.

   • Replace (Sostituisci) PAT con il tuo CodeCatalyst PAT.

   • Replace (Sostituisci) space_name con il tuo nome CodeCatalyst spaziale.

   • Replace (Sostituisci) proj_name con il nome CodeCatalyst del tuo progetto.

   • Replace (Sostituisci) repo_name con il nome CodeCatalyst del repository del pacchetto.

   npm set registry=https://packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/ --location project
   npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:_authToken=username:PAT

   Per npm 6 o versioni precedenti: per fare in modo che npm passi sempre il token di autenticazione a CodeCatalyst, anche per GET le richieste, imposta la variabile di configurazione always-auth come segue. npm config set

   npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:always-auth=true --location project

Installazione dei pacchetti npm da un repository di pacchetti CodeCatalyst

Dopo aver collegato npm al tuo repository seguendo i passaggi indicatiConfigurazione di npm con CodeCatalyst, puoi eseguire npm comandi sul tuo repository.

Puoi installare un pacchetto npm che si trova nel tuo repository di CodeCatalyst pacchetti o in uno dei suoi repository upstream con il comando. npm install

npm install lodash

Installazione dei pacchetti npm da npmjs tramite CodeCatalyst

È possibile installare i pacchetti npm da npmjs.com tramite un CodeCatalyst repository configurando il repository con una connessione upstream al repository gateway collegato a npmjs.com,. npm-public-registry-gateway I pacchetti installati da npmjs vengono inseriti e archiviati nel repository del gateway e nel repository di pacchetti più lontano a valle.

Per installare pacchetti da npmjs

1. Se non l'hai già fatto, esegui la configurazione npm con il tuo repository di CodeCatalyst pacchetti seguendo la procedura riportata di seguito. Configurazione di npm con CodeCatalyst

2. Verifica che il tuo repository abbia aggiunto il repository gateway come connessione npm-public-registry-gatewayupstream. Puoi verificare quali sorgenti upstream vengono aggiunte o aggiungerle npm-public-registry-gatewaycome sorgente upstream seguendo le istruzioni contenute Aggiungere un repository upstream e scegliendo il repository. npm-public-registry-gateway

3. Installa i pacchetti con il comando. npm install

   npm install package_name

Per ulteriori informazioni sulla richiesta di pacchetti dai repository upstream, vedere. Richiesta di una versione del pacchetto con repository upstream

Pubblicazione di pacchetti npm nel tuo repository di pacchetti CodeCatalyst

Dopo aver completatoConfigurazione di npm con CodeCatalyst, puoi eseguire npm i comandi.

È possibile pubblicare un pacchetto npm in un repository di CodeCatalyst pacchetti con il npm publish comando.

npm publish

Per informazioni su come creare pacchetti npm, vedere Creazione di moduli Node.js su npm Docs.

supporto per i comandi npm

Le sezioni seguenti riassumono i npm comandi supportati dai repository di CodeCatalyst pacchetti, oltre a elencare comandi specifici che non sono supportati.

Argomenti

• Comandi supportati che interagiscono con un archivio di pacchetti
• Comandi lato client supportati
• Comandi non supportati

Comandi supportati che interagiscono con un archivio di pacchetti

Questa sezione elenca npm i comandi in cui il npm client effettua una o più richieste al registro in cui è configurato (ad esempio,npm config set registry). È stato verificato che questi comandi funzionino correttamente quando vengono richiamati CodeCatalyst su un archivio di pacchetti.

Comando	Descrizione
bug	Indovina la posizione del bug tracker di un pacchettoURL, quindi tenta di aprirlo.
ci	Installa un progetto con una lavagna pulita.
deprecare	Depreca una versione di un pacchetto.
dist-tag	Modifica i tag di distribuzione dei pacchetti.
documenti	Indovina la posizione della documentazione di un pacchettoURL, quindi tenta di aprirla utilizzando il --browser parametro config.
dottore	Esegue una serie di controlli per verificare che l'installazione di npm sia in grado di gestire i JavaScript pacchetti.
installa	Installa un pacchetto.
install-ci-test	Installa un progetto con una lavagna pulita ed esegue dei test. Pseudonimo:. npm cit Questo comando esegue unnpm ci, seguito immediatamente da unnpm test.
install-test	Installa il pacchetto ed esegue i test. Esegue unnpm install, seguito immediatamente da unnpm test.
obsoleto	Controlla il registro configurato per determinare se i pacchetti installati sono obsoleti.
ping	Esegue il ping del registro npm configurato o specificato e verifica l'autenticazione.
pubblica	Pubblica una versione del pacchetto nel registro.
update	Indovina la posizione dell'archivio di un pacchettoURL, quindi tenta di aprirlo utilizzando il parametro config. --browser
visualizzare	Visualizza i metadati del pacchetto. Può essere utilizzato anche per stampare le proprietà dei metadati.

Comandi lato client supportati

Questi comandi non richiedono alcuna interazione diretta con un repository di pacchetti, quindi CodeCatalyst non richiedono nulla per supportarli.

Comando	Descrizione
bin (legacy)	Visualizza la bin directory npm.
costruire	Costruisce un pacchetto.
cache	Manipola la cache dei pacchetti.
completamento	Abilita il completamento delle schede in tutti i comandi npm.
config	Aggiorna il contenuto dell'utente e dei npmrc file globali.
deduplicare	Cerca nell'albero dei pacchetti locale e tenta di semplificare la struttura spostando le dipendenze più in alto nell'albero, dove possono essere condivise più efficacemente da più pacchetti dipendenti.
modifica	Modifica un pacchetto installato. Seleziona una dipendenza nella directory di lavoro corrente e apre la directory dei pacchetti nell'editor predefinito.
esplora	Esplora un pacchetto installato. Genera una subshell nella directory del pacchetto installato specificato. Se viene specificato un comando, questo viene eseguito nella sottoshell, che si spegne immediatamente.
help	Ottiene aiuto su npm.
aiuto-ricerca	Cerca nella documentazione di aiuto di npm.
init	Crea un package.json file.
collegamento	Collega simbolicamente una cartella di pacchetti.
ls	Elenca i pacchetti installati.
pacchetto	Crea un archivio tar da un pacchetto.
prefisso	Visualizza un prefisso. Questa è la directory principale più vicina a contenere un package.json file, a meno che non -g sia specificata anche questa.
prugna	Rimuove i pacchetti che non sono elencati nell'elenco delle dipendenze del pacchetto principale.
ricostruire	Esegue il npm build comando sulle cartelle corrispondenti.
riavviare	Esegue gli script di arresto, riavvio e avvio di un pacchetto e i pre-script e post-script associati.
root	Stampa la directory effettiva per renderla standardnode_modules.
esegui script	Esegue script di pacchetti arbitrari.
pellicola shrinkwrap	Blocca le versioni dipendenti per la pubblicazione.
disinstallare	Disinstalla un pacchetto.

Comandi non supportati

Questi npm comandi non sono supportati dagli archivi di CodeCatalyst pacchetti.

Comando	Descrizione	Note
accesso	Imposta il livello di accesso sui pacchetti pubblicati.	CodeCatalyst utilizza un modello di autorizzazione diverso dal repository pubblico npmjs.
aggiungi utente	Aggiunge un account utente del registro	CodeCatalyst utilizza un modello utente diverso dal repository pubblico npmjs.
audit	Esegue un controllo di sicurezza.	CodeCatalyst attualmente non vende dati sulle vulnerabilità di sicurezza.
gancio	Gestisce gli hook di npm, inclusi l'aggiunta, la rimozione, l'elenco e l'aggiornamento.	CodeCatalyst attualmente non supporta alcun meccanismo di notifica delle modifiche.
Login	Autentica un utente. Questo è un alias per npm adduser.	CodeCatalyst utilizza un modello di autenticazione diverso dal repository pubblico npmjs. Per informazioni, consultare Configurazione di npm con CodeCatalyst.
Disconnessione	Si disconnette dal registro.	CodeCatalyst utilizza un modello di autenticazione diverso dal repository pubblico npmjs. Non è possibile disconnettersi da un CodeCatalyst repository, ma i token di autenticazione scadono dopo la data di scadenza configurabile. La durata predefinita del token è di 12 ore.
proprietario	Gestisce i proprietari dei pacchetti.	CodeCatalyst utilizza un modello di autorizzazioni diverso dal repository pubblico npmjs.
profile	Modifica le impostazioni sul profilo del registro.	CodeCatalyst utilizza un modello utente diverso dal repository pubblico npmjs.
cerca	Cerca nel registro i pacchetti che corrispondono ai termini di ricerca.	CodeCatalyst non supporta il search comando.
stella	Contrassegna i tuoi pacchetti preferiti.	CodeCatalyst attualmente non supporta alcun meccanismo di preferenza.
stelle	Visualizza i pacchetti contrassegnati come preferiti.	CodeCatalyst attualmente non supporta alcun meccanismo di creazione di preferiti.
squadra	Gestisce i team e le appartenenze ai team.	CodeCatalyst utilizza un modello di appartenenza di utenti e gruppi diverso dal repository pubblico npmjs.
token	Gestisce i token di autenticazione.	CodeCatalyst utilizza un modello diverso per ottenere i token di autenticazione. Per informazioni, consultare Configurazione di npm con CodeCatalyst.
annullare la pubblicazione	Rimuove un pacchetto dal registro.	CodeCatalyst non supporta la rimozione di una versione del pacchetto da un repository utilizzando il client npm. È possibile eliminare un pacchetto nella console.
whoami	Visualizza il nome utente npm.	CodeCatalyst utilizza un modello utente diverso dal repository pubblico npmjs.