Creazione di un connettore con un'origine di streaming
Creare un connettore nell'hub connettore per trasferire i dati del flusso dal servizio di streaming a un servizio di destinazione.
Per ulteriori informazioni sul servizio di streaming, vedere Streaming.
Un connettore definito con un'origine di streaming e un task funzione (facoltativo) supporta le destinazioni seguenti: Funzioni, Logging Analytics, Storage degli oggetti e Streaming. La destinazione Notifiche è supportata solo quando non viene utilizzato alcun task funzione.
Per un esempio del flusso di lavoro dell'hub connettore, vedere Panoramica dell'hub connettore. Per un esempio di connettore che utilizza il servizio di monitoraggio come origine, vedere Scenario: invio di metriche allo storage degli oggetti.
- Per lo schema di input del flusso, vedere Riferimento messaggio.
- Per una destinazione Notifiche con origine Streaming, tutti i messaggi vengono inviati come BLOB JSON di tipo RAW.
Prima di iniziare
Per selezionare un pool di flussi e un flusso per un connettore, è necessario disporre dell'autorizzazione per leggere il pool di flussi e il flusso. Vedere Policy IAM (Securing Connector Hub).
Periodo di conservazione: origine streaming
Il periodo di conservazione per l'origine di streaming in Connector Hub è definito dal cliente. Vedere Limiti sullo streaming delle risorse. Per ulteriori informazioni sulla consegna, vedere Dettagli consegna.
Insieme al periodo di conservazione, la posizione di lettura dell'origine Streaming determina dove nel flusso iniziare a spostare i dati. La posizione di lettura viene specificata quando si specifica la connessione di origine.
Prerequisiti dell'endpoint privato per i flussi
Non è possibile eseguire il retrofit di un connettore esistente per utilizzare un flusso con un endpoint privato. Se il pool di flussi selezionato per l'origine o la destinazione del flusso è pubblico, non può essere modificato in privato e il connettore non può essere aggiornato per fare riferimento a un flusso privato. Per modificare l'origine o la destinazione in modo da utilizzare un flusso privato diverso oppure per utilizzare un'origine o una destinazione diversa da Streaming, ricreare il connettore con l'origine e la destinazione desiderate. Un esempio della necessità di un flusso privato diverso è un flusso che è stato spostato in un pool di flussi diverso. In tal caso, ricreare il connettore utilizzando il flusso spostato. Assicurarsi di disattivare o eliminare il vecchio connettore con l'origine o la destinazione del flusso che non si desidera più.
La configurazione dell'endpoint privato è supportata per i flussi di origine e di destinazione. Di seguito sono riportati i prerequisiti per l'accesso ai flussi che utilizzano endpoint privati.
- Assicurarsi di disporre delle autorizzazioni in base ai criteri seguenti:
allow group <group-name> to manage virtual-network-family in compartment id <compartment-ocid> where any {request.operation='CreatePrivateEndpoint', request.operation='UpdatePrivateEndpoint', request.operation='DeletePrivateEndpoint', request.operation='ChangePrivateEndpointCompartment', request.operation='EnableReverseConnection', request.operation='ModifyReverseConnection', request.operation='DisableReverseConnection' }allow group <group-name> to read stream-family in compartment id <compartment-ocid> - La procedura di sicurezza migliore consiste nell'individuare un flusso privato e il relativo connettore nella stessa tenancy.
Dopo aver creato il connettore, configurare le regole di entrata e uscita per consentire al connettore di accedere a tale endpoint privato. Vedere Endpoint privati: Configura regole di entrata e uscita.
Il processo di creazione inizia e ne viene visualizzato l'avanzamento. Al termine, viene visualizzata la pagina dei dettagli del connettore. Utilizzare il comando oci sch service-connector create e i parametri richiesti per creare un connettore con un'origine di streaming:
oci sch service-connector create --display-name "<display_name>" --compartment-id <compartment_OCID> --source [<stream_source_in_JSON>] --target [<target_in_JSON>]Per un elenco completo dei parametri e dei valori per i comandi della CLI, vedere il manuale CLI Command Reference.
Eseguire l'operazione CreateServiceConnector per creare un connettore.
Per creare un connettore con un'origine di streaming, inserire i dettagli di streaming in
sourcenella richiesta (CreateServiceConnectorDetails). Per un esempio, vedere StreamingSourceDetails.
Endpoint privati: configura regole di entrata e uscita
Se è stato creato un connettore con un flusso che utilizza un endpoint privato, configurare le regole di entrata e uscita per consentire al connettore di accedere a tale endpoint privato.
- Recupera gli indirizzi IP per la configurazione:
- Ottenere gli indirizzi IP per l'endpoint privato (
rceTrafficIpAddresserceDnsIpAddress) - Ottenere l'indirizzo IP per l'endpoint privato del pool di flussi visualizzando i dettagli del pool di flussi nella console. Vedere Elenco di flussi e pool di flussi.
- Ottenere gli indirizzi IP per l'endpoint privato (
- Consenti traffico primario: aggiungere una regola di entrata al NSG o alla lista di sicurezza con la configurazione seguente.
Console:
- Stateless: No
- Origine:
rceTrafficIpAddress(esempio:10.0.0.249/32) - Protocollo IP: TCP
- Intervallo porte di origine: tutto
- Intervallo di porte di destinazione: tutto
API: regola di esempio nella richiesta:
{ "protocol": "6", "source": "10.0.0.249/32" } - Aggiungere una regola di uscita alla lista di sicurezza con la configurazione seguente.
Console:
- Stateless: No
- Origine:
streamPoolIpAddress(esempio:10.0.0.20/32) - Protocollo IP: TCP
- Intervallo porte di origine: tutto
- Intervallo di porte di destinazione: tutto
API: regola di esempio nella richiesta:
{ "destination": "10.0.0.20/32", "protocol": "6" }
Non è possibile eseguire il retrofit di un connettore esistente per utilizzare un flusso con un endpoint privato. Se il pool di flussi selezionato per l'origine o la destinazione del flusso è pubblico, non può essere modificato in privato e il connettore non può essere aggiornato per fare riferimento a un flusso privato. Per modificare l'origine o la destinazione in modo da utilizzare un flusso privato diverso oppure per utilizzare un'origine o una destinazione diversa da Streaming, ricreare il connettore con l'origine e la destinazione desiderate. Un esempio della necessità di un flusso privato diverso è un flusso che è stato spostato in un pool di flussi diverso. In tal caso, ricreare il connettore utilizzando il flusso spostato. Assicurarsi di disattivare o eliminare il vecchio connettore con l'origine o la destinazione del flusso che non si desidera più.
Confermare che il nuovo connettore sposta i dati
Dopo aver creato il connettore, confermarne lo spostamento.
- Abilita log per il connettore per ottenere i dettagli sul flusso di dati.
- Controllare i risultati previsti nel servizio di destinazione.
La conferma dello spostamento dei dati consente di evitare la disattivazione automatica, che si verifica quando un connettore si guasta per un lungo periodo di tempo.
Flussi privati: non è possibile eseguire il retrofit di un connettore esistente per utilizzare un flusso con un endpoint privato. Se il pool di flussi selezionato per l'origine o la destinazione del flusso è pubblico, non può essere modificato in privato e il connettore non può essere aggiornato per fare riferimento a un flusso privato. Per modificare l'origine o la destinazione in modo da utilizzare un flusso privato diverso oppure per utilizzare un'origine o una destinazione diversa da Streaming, ricreare il connettore con l'origine e la destinazione desiderate. Un esempio della necessità di un flusso privato diverso è un flusso che è stato spostato in un pool di flussi diverso. In tal caso, ricreare il connettore utilizzando il flusso spostato. Assicurarsi di disattivare o eliminare il vecchio connettore con l'origine o la destinazione del flusso che non si desidera più.