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à.
# Utilizzo degli host
Per creare una connessione a un tipo di provider installato, ad esempio GitHub Enterprise Server, è innanzitutto necessario creare un host utilizzando il Console di gestione AWS. Un host è una risorsa creata per rappresentare l'infrastruttura in cui è installato il provider. Quindi si crea una connessione utilizzando tale host. Per ulteriori informazioni, consulta [Utilizzo delle connessioni](connections.md).
Ad esempio, si crea un host per la connessione in modo che l'app di terze parti per il provider possa essere registrata per rappresentare l'infrastruttura. Si crea un host per un tipo di provider, e tutte le connessioni a tale tipo di provider utilizzeranno tale host.
Quando si utilizza la console per creare una connessione a un tipo di provider installato, ad esempio GitHub Enterprise Server, la console crea la risorsa host per l'utente.
**Topics**
+ [Creazione di un host](connections-host-create.md)
+ [Impostare un host in attesa](connections-host-setup.md)
+ [Elenca gli host](connections-host-list.md)
+ [Modificare un host](connections-host-edit.md)
+ [Eliminare un host](connections-host-delete.md)
+ [Visualizzare i dettagli dell'host](connections-host-view.md)
# Creare di un host
Puoi usare Console di gestione AWS o the AWS Command Line Interface (AWS CLI) per creare una connessione a un repository di codice di terze parti installato sulla tua infrastruttura. Ad esempio, potresti avere GitHub Enterprise Server in esecuzione come macchina virtuale su un'istanza Amazon EC2. Prima di creare una connessione a GitHub Enterprise Server, crei un host da utilizzare per la connessione.
Per una panoramica del flusso di lavoro di creazione di un host per i provider installati, consulta [Flusso di lavoro per la creazione o l'aggiornamento di un host](welcome-hosts-workflow.md).
Prima di iniziare:
+ (Facoltativo) Se desideri creare l'host con un VPC, devi aver già creato una rete o un cloud privato virtuale (VPC).
+ Devi aver già creato l'istanza e, se prevedi di connetterti con il VPC, aver avviato l'host nel VPC.
**Nota**
Ogni VPC può essere associato solo a un host alla volta.
Facoltativamente, puoi configurare l'host con un VPC. Per ulteriori informazioni sulla configurazione di rete e del VPC per la risorsa host consulta i prerequisiti VPC in [(Facoltativo) Prerequisiti: configurazione di rete o Amazon VPC per la connessione](#connections-create-host-prereq) e [Risoluzione dei problemi di configurazione VPC per l'host](troubleshooting-connections.md#troubleshooting-connections-host-vpc).
Per utilizzare la console per creare un host e una connessione a GitHub Enterprise Server, vedere[Crea la tua connessione GitHub Enterprise Server (console)](connections-create-gheserver-console.md#connections-create-gheserver-connection). La console crea il tuo host.
Per utilizzare la console per creare un host e una connessione a GitLab gestione automatica, vedere[Crea una connessione a gestione automatica GitLab](connections-create-gitlab-managed.md). La console crea il tuo host.
## (Facoltativo) Prerequisiti: configurazione di rete o Amazon VPC per la connessione
Se l'infrastruttura è configurata con una connessione di rete, è possibile ignorare questa sezione.
Se l'host è accessibile solo in un VPC, prima di continuare, attieniti ai requisiti VPC.
### Requisiti VPC
Puoi scegliere facoltativamente di creare l'host con un VPC. Di seguito sono riportati i requisiti VPC generali, a seconda del VPC configurato per l'installazione.
+ È possibile configurare un VPC *pubblico* con sottoreti pubbliche e private. È possibile utilizzare il VPC predefinito per l' Account AWS se non sono presenti sottoreti o blocchi CIDR preferiti.
+ Se hai configurato un VPC *privato* e hai configurato l'istanza di GitHub Enterprise Server per eseguire la convalida TLS utilizzando un'autorità di certificazione non pubblica, devi fornire il certificato TLS per la risorsa host.
+ Quando connections crea il tuo host, l'endpoint VPC (PrivateLink) per i webhook viene creato automaticamente. Per ulteriori informazioni, consulta [AWS CodeConnections e endpoint VPC di interfaccia ()AWS PrivateLink](vpc-interface-endpoints.md).
+ Configurazione del gruppo di sicurezza:
+ I gruppi di sicurezza utilizzati durante la creazione dell'host necessitano di regole in entrata e in uscita che consentano all'interfaccia di rete di connettersi all'istanza di Enterprise Server GitHub
+ I gruppi di sicurezza collegati all'istanza di GitHub Enterprise Server (che non fanno parte della configurazione dell'host) richiedono l'accesso in entrata e in uscita dalle interfacce di rete create dalle connessioni.
+ Le sottoreti VPC devono risiedere in diverse zone di disponibilità della regione. Le zone di disponibilità sono sedi isolate dai guasti che si verificano in altre zone di disponibilità. Ogni sottorete deve risiedere totalmente all'interno di una zona di disponibilità e non può estendersi in altre zone.
*Per ulteriori informazioni sull'utilizzo delle sottoreti VPCs e delle sottoreti, consulta [VPC and Subnet Sizing nella](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-sizing-ipv4) Amazon VPC User IPv4 Guide.*
**Informazioni VPC fornite per la configurazione dell'host**
Quando si crea la risorsa host per le connessioni nella fase successiva, è necessario fornire quanto segue:
+ ID **VPC: l'ID** del VPC per il server su cui è installata l'istanza di GitHub Enterprise Server o un VPC che ha accesso all'istanza di GitHub Enterprise Server installata tramite VPN o Direct Connect.
+ **ID di sottorete o IDs:** l'ID della sottorete per il server su cui è installata l'istanza di GitHub Enterprise Server o una sottorete con accesso all'istanza di GitHub Enterprise Server installata tramite VPN o Direct Connect.
+ **Gruppo o gruppi di sicurezza:** il gruppo di sicurezza per il server su cui è installata l'istanza di GitHub Enterprise Server o un gruppo di sicurezza con accesso all'istanza di GitHub Enterprise Server installata tramite VPN o Direct Connect.
+ **Endpoint:** avere l'endpoint del server pronto e continuare con la fase successiva.
Per ulteriori informazioni, inclusa la risoluzione dei problemi di connessione VPC o host, consulta [Risoluzione dei problemi di configurazione VPC per l'host](troubleshooting-connections.md#troubleshooting-connections-host-vpc).
### Requisiti per l'autorizzazione
Come parte del processo di creazione dell'host, AWS CodeConnections crea risorse di rete per conto dell'utente per facilitare la connettività VPC. Ciò include un'interfaccia di rete AWS CodeConnections per interrogare i dati dall'host e un endpoint VPC o *PrivateLink*per l'host per inviare i dati degli eventi tramite webhook alle connessioni. Per poter creare queste risorse di rete, è necessario assicurarsi che l'utente IAM che crea l'host disponga delle seguenti autorizzazioni:
```
ec2:CreateNetworkInterface
ec2:CreateTags
ec2:DescribeDhcpOptions
ec2:DescribeNetworkInterfaces
ec2:DescribeSubnets
ec2:DeleteNetworkInterface
ec2:DescribeVpcs
ec2:CreateVpcEndpoint
ec2:DeleteVpcEndpoints
ec2:DescribeVpcEndpoints
```
Per ulteriori informazioni sulle autorizzazioni per la risoluzione dei problemi o la connessione host in un VPC, consulta [Risoluzione dei problemi di configurazione VPC per l'host](troubleshooting-connections.md#troubleshooting-connections-host-vpc).
Per ulteriori informazioni sul webhook endpoint VPC, consulta [AWS CodeConnections e endpoint VPC di interfaccia ()AWS PrivateLink](vpc-interface-endpoints.md).
**Topics**
+ [
## (Facoltativo) Prerequisiti: configurazione di rete o Amazon VPC per la connessione
](#connections-create-host-prereq)
+ [
## Creare un host per una connessione (console)
](#connections-host-create-console)
+ [
## Creazione di un host per una connessione (CLI)
](#connections-host-create-cli)
## Creare un host per una connessione (console)
Per le connessioni per le installazioni, ad esempio con GitHub Enterprise Server o con GitLab gestione automatica, si utilizza un host per rappresentare l'endpoint per l'infrastruttura in cui è installato il provider di terze parti.
**Nota**
A partire dal 1° luglio 2024, la console crea connessioni con `codeconnections` la risorsa ARN. Le risorse con entrambi i prefissi di servizio continueranno a essere visualizzate nella console.
Per informazioni sulle considerazioni relative alla configurazione di un host in un VPC, consulta [Crea una connessione a gestione automatica GitLab](connections-create-gitlab-managed.md).
Per utilizzare la console per creare un host e una connessione a GitHub Enterprise Server, vedere. [Crea la tua connessione GitHub Enterprise Server (console)](connections-create-gheserver-console.md#connections-create-gheserver-connection) La console crea il tuo host.
Per utilizzare la console per creare un host e una connessione a GitLab gestione automatica, vedere[Crea una connessione a gestione automatica GitLab](connections-create-gitlab-managed.md). La console crea il tuo host.
**Nota**
È possibile creare un host solo una volta per GitHub Enterprise Server o account GitLab autogestito. Tutte le connessioni a uno specifico GitHub Enterprise Server o a un account GitLab autogestito utilizzeranno lo stesso host.
## Creazione di un host per una connessione (CLI)
È possibile utilizzare AWS Command Line Interface (AWS CLI) per creare un host per le connessioni installate.
**Nota**
È possibile creare un host solo una volta per account GitHub Enterprise Server. Tutte le connessioni a un account GitHub Enterprise Server specifico utilizzeranno lo stesso host.
È possibile utilizzare un host per rappresentare l'endpoint per l'infrastruttura in cui è installato il provider di terze parti. Per creare un host con la CLI, utilizza il comando **create-host**. Dopo aver completato la creazione dell'host, l'host si trova nello stato **Pending (In attesa)**. Allora si può *Configurare* l'host per spostarlo nello stato **Available (Disponibile)**. Quando l'host sarà disponibile, completa i passaggi per creare una connessione.
**Importante**
Per impostazione predefinita, un host creato tramite il AWS CLI è attivo. `Pending` Dopo aver creato un host con la CLI, utilizza la console per configurare l'host e impostarne lo stato `Available`.
Per utilizzare la console per creare un host e una connessione a GitHub Enterprise Server, vedere[Crea la tua connessione GitHub Enterprise Server (console)](connections-create-gheserver-console.md#connections-create-gheserver-connection). La console crea il tuo host.
Per utilizzare la console per creare un host e una connessione a GitLab gestione automatica, vedere[Crea una connessione a gestione automatica GitLab](connections-create-gitlab-managed.md). La console crea il tuo host.
# Impostare un host in attesa
Un host creato tramite AWS Command Line Interface (AWS CLI) o SDK è in `Pending` stato per impostazione predefinita. Dopo aver creato una connessione con la console o l'SDK, utilizza la console per configurare l'host e impostarne lo stato. AWS CLI`Available`
È necessario avere già creato un host. Per ulteriori informazioni, consulta la sezione [Creazione di un host](connections-host-create.md).
**Per impostare un host in attesa**
Una volta creato, l'host si trova nello stato **Pending (In attesa)**. Per spostare l'host da **Pending (In attesa)** a **Available (Disponibile)**, completa questi passaggi. Questo processo esegue una stretta di mano con il provider terzo per registrare l'app di AWS connessione sull'host.
1. Dopo che l'host ha raggiunto lo stato **In sospeso** nella console AWS Developer Tools, scegli **Configura** host.
1. Se stai creando un host per la GitLab gestione automatica, viene visualizzata una pagina di **configurazione**. In **Fornisci un token di accesso personale**, fornisci GitLab al tuo PAT solo la seguente autorizzazione riportata di seguito: api.
1. Nella pagina di accesso del provider installato da terze parti, ad esempio la pagina di accesso di **GitHub Enterprise Server**, accedi con le credenziali del tuo account, se richiesto.
1. Nella pagina di installazione dell'app, in **Nome GitHub app**, inserisci un nome per l'app che desideri installare per il tuo host. Scegli **Crea GitHub app**.
1. Dopo che l'host è stato registrato correttamente, viene visualizzata la pagina dei dettagli dell'host che mostra che lo stato dell'host è **Available (Disponibile)**.
![\[Schermata della console che mostra che la configurazione dell'host è completa e nello stato Disponibile.\]](http://docs.aws.amazon.com/it_it/dtconsole/latest/userguide/images/connections-create-host-register-complete.png)
1. È possibile continuare con la creazione della connessione una volta che l'host è disponibile. Nel banner che indica l'esito positivo, scegli **Create connection** (Crea connessione). Completa i passaggi descritti in [Creazione di una connessione](connections-create-gheserver-console.md).
# Elenca gli host
È possibile utilizzare la console di Strumenti per sviluppatori o il comando **list-connections** nell’ AWS Command Line Interface (AWS CLI) per visualizzare un elenco di connessioni nel proprio account.
## Elenca gli host (console)
**Per elencare gli host**
1. Apri la console Strumenti di sviluppo all'indirizzo [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Seleziona la scheda **Hosts (Host)**. Visualizza il nome, lo stato e l'ARN per gli host.
## Elenca gli host (CLI)
Puoi utilizzarlo AWS CLI per elencare gli host per le connessioni installate con provider di terze parti.
Per farlo, utilizzare il comando **list-hosts**.
**Per elencare gli host**
+ Aprire un terminale (Linux, macOS o Unix) o un prompt dei comandi (Windows) e AWS CLI utilizzarlo per eseguire il comando. **list-hosts**
```
aws codeconnections list-hosts
```
Questo comando restituisce il seguente output.
```
{
"Hosts": [
{
"Name": "My-Host",
"HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605",
"ProviderType": "GitHubEnterpriseServer",
"ProviderEndpoint": "https://my-instance.test.dev",
"Status": "AVAILABLE"
}
]
}
```
# Modificare un host
È possibile modificare le impostazioni dell'host per un host nello stato `Pending`. È possibile modificare il nome host, l'URL o la configurazione VPC.
Non è possibile utilizzare lo stesso URL per più di un host.
**Nota**
Per informazioni sulle considerazioni relative alla configurazione di un host in un VPC, consulta [(Facoltativo) Prerequisiti: configurazione di rete o Amazon VPC per la connessione](connections-host-create.md#connections-create-host-prereq).
**Per modificare un host**
1. Apri la console Strumenti di sviluppo all'indirizzo [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Scegli **Settings > Connections (Impostazioni > Connessioni)**.
1. Seleziona la scheda **Hosts (Host)**.
Vengono visualizzati gli host associati al tuo AWS account e creati nella AWS regione selezionata.
1. Per modificare il nome host, immetti un nuovo valore in **Nome**.
1. Per modificare il l'endpoint dell'host immetti un nuovo valore in **URL**.
1. Per modificare la configurazione VPC host, immetti nuovi valori in **ID VPC**.
1. Scegli **Edit host (Modifica host)**.
1. Vengono visualizzate le impostazioni aggiornate. Scegli **Set up Pending host (Imposta host in attesa)**.
# Eliminare un host
È possibile utilizzare la console Strumenti di sviluppo o il comando **delete-host** in AWS Command Line Interface (AWS CLI) per eliminare un host.
**Topics**
+ [
## Eliminare un host (console)
](#connections-host-delete-console)
+ [
## Eliminare un host (CLI)
](#connections-host-delete-cli)
## Eliminare un host (console)
**Per eliminare un host**
1. Apri la console Strumenti di sviluppo all'indirizzo [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Seleziona la scheda **Hosts (Host)**. In **Name (Nome)**, scegli il nome dell'host da eliminare.
1. Scegli **Elimina**.
1. Digitare **delete** nel campo per confermare e quindi scegliere **Delete (Elimina)**.
**Importante**
Questa operazione non può essere annullata.
## Eliminare un host (CLI)
È possibile utilizzare AWS Command Line Interface (AWS CLI) per eliminare un host.
Per farlo, utilizzare il comando **delete-host**.
**Importante**
Per eliminare un host, è necessario eliminare tutte le connessioni associate all'host.
Dopo aver eseguito il comando, l'host viene eliminato. Non viene visualizzata alcuna finestra di dialogo di conferma.
**Per eliminare un host**
+ Apri un terminale (Linux, macOS o Unix) o prompt dei comandi (Windows). Usa AWS CLI per eseguire il **delete-host** comando, specificando l'Amazon Resource Name (ARN) dell'host che desideri eliminare.
```
aws codeconnections delete-host --host-arn "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
```
Questo comando non restituisce alcun risultato.
# Visualizzare i dettagli dell'host
È possibile utilizzare la console Strumenti di sviluppo o il comando **get-host** in AWS Command Line Interface (AWS CLI) per visualizzare i dettagli dell'host.
**Per visualizzare i dettagli dell'host (console)**
1. Accedi alla Console di gestione AWS e apri la console Strumenti di sviluppo all'indirizzo [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Scegli **Settings > Connections (Impostazioni > Connessioni)**, quindi seleziona la scheda **Hosts (Host)**.
1. Seleziona il pulsante accanto all'host che desideri visualizzare, quindi seleziona **View details (Visualizza i dettagli)**.
1. Vengono visualizzate le seguenti informazioni per l'host:
+ Il nome host.
+ Il tipo di provider per la connessione.
+ L'endpoint dell'infrastruttura in cui è installato il provider.
+ Lo stato di configurazione per l'host. Un host pronto per una connessione è nello stato **Available (Disponibile)**. Se l'host è stato creato ma l'installazione non è stata completata, l'host potrebbe trovarsi in uno stato diverso.
Sono disponibili i seguenti stati:
+ IN ATTESA - L'host ha completato la creazione ed è pronto per avviare la configurazione registrando l'app provider sull'host.
+ DISPONIBILE - L'host ha completato la creazione e la configurazione ed è disponibile per l'utilizzo con le connessioni.
+ ERRORE - Si è verificato un errore durante la creazione o la registrazione dell'host.
+ VPC\$1CONFIG\$1VPC\$1INIZIALIZZAZIONE - Viene creata la configurazione VPC per l'host.
+ VPC\$1CONFIG\$1VPC\$1INIZIALIZZAZIONE\$1FALLITA - La configurazione VPC per l'host ha rilevato e errore e non è riuscita.
+ VPC\$1CONFIG\$1VPC\$1DISPONIBILE - La configurazione VPC per l'host ha completato l'installazione ed è disponibile.
+ VPC\$1CONFIG\$1VPC\$1ELIMINAZIONE - Viene eliminata la configurazione VPC per l'host.
![\[Schermata della console che mostra i dettagli dell'host con l'host in stato Disponibile.\]](http://docs.aws.amazon.com/it_it/dtconsole/latest/userguide/images/connections-view-host-screen.png)
1. Per eliminare l'host, scegli **Delete (Elimina)**.
1. Se l'host è nello stato **Pending (In attesa)**, per completare la configurazione, scegli **Set up host (Configura host)**. Per ulteriori informazioni, consulta [Set up a pending host (Impostare un host in attesa)](connections-host-setup.md).
**Per visualizzare i dettagli dell'host (CLI)**
+ Apri un terminale (Linux, macOS o Unix) o un prompt dei comandi (Windows) e usalo AWS CLI per eseguire il **get-host** comando, specificando l'Amazon Resource Name (ARN) dell'host di cui desideri visualizzare i dettagli.
```
aws codeconnections get-host --host-arn arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605
```
Questo comando restituisce il seguente output.
```
{
"Name": "MyHost",
"Status": "AVAILABLE",
"ProviderType": "GitHubEnterpriseServer",
"ProviderEndpoint": "https://test-instance-1.dev/"
}
```