Modifica del proxy RDS - Amazon Aurora

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à.

Modifica del proxy RDS

Puoi modificare specifiche impostazioni associate a un proxy dopo aver creato il proxy. Esegui questa operazione modificando il proxy stesso, il suo gruppo di destinazione associato o entrambi. Ogni proxy ha un gruppo di destinazione associato.

Importante

I valori nei campi Tipo di autenticazione Client e IAMautenticazione si applicano a tutti i segreti di Secrets Manager associati a questo proxy. Per specificare valori diversi per ogni segreto, modifica il proxy utilizzando API invece il AWS CLI o il.

Per modificare le impostazioni di un proxy

  1. Accedi a AWS Management Console e apri la RDS console Amazon all'indirizzo https://console.aws.amazon.com/rds/.

  2. Nel riquadro di navigazione scegli Proxies (Proxy).

  3. Nell'elenco dei proxy, scegli il proxy di cui desideri modificare le impostazioni o passa alla relativa pagina dei dettagli.

  4. Per Actions (Operazioni), scegliere Modify (Modifica).

  5. Inserisci o scegli le proprietà da modificare. È possibile modificare le seguenti:

    • L'identificatore Proxy: rinominare il proxy immettendo un nuovo identificatore.

    • Timeout della connessione client per inattività: immettere un periodo di tempo per il timeout della connessione client inattiva.

    • IAMrole — Cambia il IAM ruolo usato per recuperare i segreti da Secrets Manager.

    • Segreti di Secrets Manager: aggiungere o rimuovere segreti di Secrets Manager. Questi segreti corrispondono a nomi utente e password del database.

    • Tipo di autenticazione client: (SQLsolo Postgre) Modifica il tipo di autenticazione per le connessioni dei client al proxy.

    • IAMautenticazione: richiede o non consente l'IAMautenticazione per le connessioni al proxy.

    • Richiedi Transport Layer Security: attiva o disattiva il requisito di Transport Layer Security (TLS).

    • VPCgruppo di sicurezza: aggiunge o rimuove i gruppi di VPC sicurezza da utilizzare dal proxy.

    • Abilitazione della registrazione avanzata: abilitare o disabilitare la registrazione avanzata.

  6. Scegliere Modify (Modifica).

Se non sono state trovate le impostazioni elencate che si desidera modificare, attenersi alla procedura seguente per aggiornare il gruppo di destinazione per il proxy. Il gruppo di destinazione associato a un proxy controlla le impostazioni relative alle connessioni del database fisico. Ogni proxy ha un gruppo di destinazione associato denominato default, che viene creato automaticamente insieme al proxy.

Puoi modificare il gruppo di destinazione solo dalla pagina dei dettagli del proxy, non dall'elenco nella pagina Proxies (Proxy) .

Per modificare le impostazioni di un gruppo di destinazione proxy

  1. Dalla pagina Proxy, passa alla pagina dei dettagli di un proxy.

  2. Per Target groups (Gruppi di destinazione), scegli il collegamento di default. Attualmente, tutti i proxy hanno un singolo gruppo di destinazione denominato default.

  3. Nella pagina dei dettagli del gruppo di destinazione di default, scegli Modify (Modifica).

  4. Scegli nuove impostazioni per le proprietà che è possibile modificare:

    • Database: scegli un' Aurora diverso.

    • Connessioni massime del pool di connessioni: puoi modificare la percentuale delle connessioni massime disponibili che il proxy può utilizzare.

    • Filtri di pinning della sessione: (opzionale) scegliere un filtro di pinning della sessione. Ciò elude le misure di sicurezza predefinite per il multiplexing delle connessioni al database tra connessioni client. Attualmente, l'impostazione non è supportata per SQL Postgre. L'unica scelta è. EXCLUDE_VARIABLE_SETS

      L'attivazione di questa impostazione può far sì che le variabili di sessione di una connessione influiscano sulle altre connessioni. Ciò può causare errori o problemi di correttezza se le query dipendono dai valori delle variabili di sessione impostati al di fuori della transazione corrente. Valuta l'utilizzo di questa opzione dopo aver verificato che sia sicuro per le applicazioni condividere le connessioni al database tra connessioni client.

      I seguenti modelli possono essere considerati sicuri:

      • Istruzioni SET in cui non viene apportata alcuna modifica al valore della variabile di sessione effettiva, ovvero non viene apportata alcuna modifica alla variabile di sessione.

      • Modifichi il valore della variabile di sessione ed esegui un'istruzione nella stessa transazione.

      Per ulteriori informazioni, consulta Evitare di bloccare un proxy RDS.

    • Timeout del prestito di connessione: puoi regolare l'intervallo di timeout del prestito di connessione. Questa impostazione si applica quando il numero massimo di connessioni è già in uso per il proxy. In questi casi, è possibile specificare per quanto tempo il proxy attende che una connessione diventi disponibile prima di restituire un errore di timeout.

    • Query di inizializzazione: (opzionale) aggiungere una query di inizializzazione o modificare quella corrente. È possibile specificare una o più SQL istruzioni per l'esecuzione del proxy all'apertura di ogni nuova connessione al database. L'impostazione è in genere utilizzata con le istruzioni SET per assicurarsi che ogni connessione abbia impostazioni identiche, ad esempio fuso orario e set di caratteri. Per più istruzioni, utilizzare il punto e virgola come separatore. È inoltre possibile includere più variabili in una singola istruzione SET, ad esempio SET x=1, y=2.

    Alcune proprietà, ad esempio l'identificatore del gruppo di destinazione e il motore del database, sono fisse.

  5. Scegli Modify target group (Modifica gruppo di destinazione).

Per modificare un proxy utilizzando il AWS CLI, usa i comandi modify-db-proxymodify-db-proxy-target-group deregister-db-proxy-targets, e register-db-proxy-targets.

Con il comando modify-db-proxy, è possibile modificare proprietà come le seguenti:

  • L'insieme di segreti Secrets Manager usati dal proxy.

  • Se TLS è obbligatorio.

  • Il timeout del client inattivo.

  • Se registrare informazioni aggiuntive dalle SQL istruzioni per il debug.

  • Il IAM ruolo utilizzato per recuperare i segreti di Secrets Manager.

  • I gruppi di sicurezza utilizzati dal proxy.

Nell'esempio seguente viene illustrato come rinominare un proxy esistente. 

aws rds modify-db-proxy --db-proxy-name the-proxy --new-db-proxy-name the_new_name

Con il comando modify-db-proxy-target-group, puoi modificare le impostazioni relative alla connessione o rinominare il gruppo di destinazione. Attualmente, tutti i proxy hanno un singolo gruppo di destinazione denominato default. Quando lavori con questo gruppo di destinazione, devi specificare il nome del proxy e default per il nome del gruppo di destinazione.

Nell'esempio seguente viene illustrato come controllare prima l'impostazione MaxIdleConnectionsPercent per un proxy e quindi modificarla utilizzando il gruppo di destinazione. 

aws rds describe-db-proxy-target-groups --db-proxy-name the-proxy

{
    "TargetGroups": [
        {
            "Status": "available",
            "UpdatedDate": "2019-11-30T16:49:30.342Z",
            "ConnectionPoolConfig": {
                "MaxIdleConnectionsPercent": 50,
                "ConnectionBorrowTimeout": 120,
                "MaxConnectionsPercent": 100,
                "SessionPinningFilters": []
            },
            "TargetGroupName": "default",
            "CreatedDate": "2019-11-30T16:49:27.940Z",
            "DBProxyName": "the-proxy",
            "IsDefault": true
        }
    ]
}

aws rds modify-db-proxy-target-group --db-proxy-name the-proxy --target-group-name default --connection-pool-config '
{ "MaxIdleConnectionsPercent": 75 }'

{
    "DBProxyTargetGroup": {
        "Status": "available",
        "UpdatedDate": "2019-12-02T04:09:50.420Z",
        "ConnectionPoolConfig": {
            "MaxIdleConnectionsPercent": 75,
            "ConnectionBorrowTimeout": 120,
            "MaxConnectionsPercent": 100,
            "SessionPinningFilters": []
        },
        "TargetGroupName": "default",
        "CreatedDate": "2019-11-30T16:49:27.940Z",
        "DBProxyName": "the-proxy",
        "IsDefault": true
    }
}

Con i register-db-proxy-targets comandi deregister-db-proxy-targets and, è possibile modificare dei cluster Aurora DB a cui il proxy è associato tramite il relativo gruppo di destinazione. Attualmente, ogni proxy può connettersi a un cluster Aurora DB. Il gruppo target tiene traccia dei dettagli di connessione per tutte le , tutte le istanze DB in un cluster Aurora.

L'esempio seguente inizia con un proxy associato a un SQL cluster Aurora My denominato. cluster-56-2020-02-25-1399 Nell'esempio viene illustrato come modificare il proxy in modo che possa connettersi a un cluster diverso denominato provisioned-cluster.

Quando utilizzi un cluster di database Aurora, specifichi l'opzione --db-cluster-identifier.

L'esempio seguente modifica un proxy Aurora MySQL. Un SQL proxy Aurora Postgre ha la porta 5432. 

aws rds describe-db-proxy-targets --db-proxy-name the-proxy

{
    "Targets": [
        {
            "Endpoint": "instance-9814.demo.us-east-1.rds.amazonaws.com",
            "Type": "RDS_INSTANCE",
            "Port": 3306,
            "RdsResourceId": "instance-9814"
        },
        {
            "Endpoint": "instance-8898.demo.us-east-1.rds.amazonaws.com",
            "Type": "RDS_INSTANCE",
            "Port": 3306,
            "RdsResourceId": "instance-8898"
        },
        {
            "Endpoint": "instance-1018.demo.us-east-1.rds.amazonaws.com",
            "Type": "RDS_INSTANCE",
            "Port": 3306,
            "RdsResourceId": "instance-1018"
        },
        {
            "Type": "TRACKED_CLUSTER",
            "Port": 0,
            "RdsResourceId": "cluster-56-2020-02-25-1399"
        },
        {
            "Endpoint": "instance-4330.demo.us-east-1.rds.amazonaws.com",
            "Type": "RDS_INSTANCE",
            "Port": 3306,
            "RdsResourceId": "instance-4330"
        }
    ]
}

aws rds deregister-db-proxy-targets --db-proxy-name the-proxy --db-cluster-identifier cluster-56-2020-02-25-1399

aws rds describe-db-proxy-targets --db-proxy-name the-proxy

{
    "Targets": []
}

aws rds register-db-proxy-targets --db-proxy-name the-proxy --db-cluster-identifier provisioned-cluster

{
    "DBProxyTargets": [
        {
            "Type": "TRACKED_CLUSTER",
            "Port": 0,
            "RdsResourceId": "provisioned-cluster"
        },
        {
            "Endpoint": "gkldje.demo.us-east-1.rds.amazonaws.com",
            "Type": "RDS_INSTANCE",
            "Port": 3306,
            "RdsResourceId": "gkldje"
        },
        {
            "Endpoint": "provisioned-1.demo.us-east-1.rds.amazonaws.com",
            "Type": "RDS_INSTANCE",
            "Port": 3306,
            "RdsResourceId": "provisioned-1"
        }
    ]
}

Per modificare un proxy utilizzando le RDSAPI, si utilizzano le operazioni ModifyDBProxy, M odifyDBProxy TargetGroup, D eregisterDBProxy Targets e R egisterDBProxy Targets.

Con ModifyDBProxy, è possibile modificare proprietà come le seguenti:

  • L'insieme di segreti Secrets Manager usati dal proxy.

  • Se TLS è obbligatorio.

  • Il timeout del client inattivo.

  • Se registrare informazioni aggiuntive dalle SQL istruzioni per il debug.

  • Il IAM ruolo utilizzato per recuperare i segreti di Secrets Manager.

  • I gruppi di sicurezza utilizzati dal proxy.

Con ModifyDBProxyTargetGroup, puoi modificare le impostazioni relative alla connessione o rinominare il gruppo di destinazione. Attualmente, tutti i proxy hanno un singolo gruppo di destinazione denominato default. Quando lavori con questo gruppo di destinazione, devi specificare il nome del proxy e default per il nome del gruppo di destinazione.

Con DeregisterDBProxyTargets eRegisterDBProxyTargets, si modifica l' a cui il cluster Aurora è associato il proxy tramite il relativo gruppo di destinazione. Attualmente, ogni proxy può connettersi a un cluster Aurora di . Il gruppo target tiene traccia dei dettagli di connessione per le , istanze DB in un cluster Aurora.