Gestione dei principal risorse
È possibile gestire i principal delle risorse cluster del servizio Big Data dalla pagina Dettagli cluster.
È consentita una sola configurazione di principal risorsa attiva per cluster.
Big Data Service 3.0.28 e ODH versione 1.1.13/2.0.9 supportano i principal delle risorse. I cluster precedenti che seguono il percorso di aggiornamento con Big Data Service 3.0.27 minimo (creazione cluster diretta o aggiornamento) sono idonei per l'upgrade per supportare i principal delle risorse. Per utilizzare i principal delle risorse, è necessario aggiornare sia il servizio Big Data che ODH alle versioni elencate in precedenza. Con l'introduzione del supporto del principal delle risorse, Big Data Service può connettersi a diversi servizi OCI utilizzando l'autenticazione del principal delle risorse e i criteri possono essere definiti per più livelli (livello di risorsa, livello di compartimento e così via).
Per gestire i principal delle risorse cluster di Big Data Service, vedere:
- Creazione di una principal risorsa
- Modifica di un principal risorsa
- Eliminazione di una risorsa principale
- Rigenerazione di un token principal risorsa
- Recupero dei dettagli principal risorsa
- Lista dei principal risorsa
Un nuovo token di sessione del principal risorsa viene emesso e distribuito a tutti i nodi del cluster nelle situazioni riportate di seguito.
- Sostituzione di un nodo
- Aggiunta di un nodo
Prerequisiti
- Big Data Service 3.0.28 o versione successiva
- ODH 1.1.13 o versione successiva per ODH 1
- ODH 2.0.9 o versione successiva per ODH 2
- L'autorizzazione
update bds
Per ulteriori informazioni sui criteri di Big Data Service, vedere Criteri di Big Data Service
Criteri di esempio
È possibile creare i criteri riportati di seguito anche per un gruppo specifico.
Consenti accesso in sola lettura a Big Data Service agli oggetti e ai bucket nella tenancy per un cluster
allow any-user to read buckets in tenancy where ALL{request.principal.id='<BDS Cluster OCID>'}
allow any-user to read objects in tenancy where ALL{request.principal.id='<BDS Cluster OCID>'}
Consenti accesso in sola lettura a bucket specifici nella tenancy per il cluster Big Data Service
allow any-user to read buckets in tenancy where ALL{request.principal.id='<BDS Cluster OCID>',target.bucket.name='<bucket-name>'}
allow any-user to read objects in tenancy where ALL{request.principal.id='<BDS Cluster OCID>',target.bucket.name='<bucket-name>'}
Consenti accesso in sola lettura agli oggetti e ai bucket nella tenancy per tutti i cluster del servizio Big Data che hanno origine da un compartimento specifico
allow any-user to read buckets in tenancy where ALL{request.resource.compartment.id='<Compartment OCID of BDS Clusters>', request.principal.type='bigdataservice'}
allow any-user to read objects in tenancy where ALL{request.resource.compartment.id='<Compartment OCID of BDS Clusters>', request.principal.type='bigdataservice'}
Consenti accesso in sola lettura agli oggetti e ai bucket in tenant diversi per il cluster Big Data Service (ad esempio, l'accesso tra tenancy)
Criteri necessari nella tenancy di origine in cui è stato creato il cluster Big Data Service effettivo.
Define tenancy <Target-Tenancy-Name> as <Target-Tenancy-OCID>
Endorse any-user to read object-family in tenancy <Target-Tenancy-Name>
Endorse any-user to read buckets in tenancy <Target-Tenancy-Name>
Endorse any-user to read objects in tenancy <Target-Tenancy-Name>
Criteri necessari nella tenancy di destinazione in cui si accede alle risorse.
Define tenancy <Source-BDS-Cluster-Tenancy-Name> as <Source-BDS-Cluster-Tenancy-OCID>
Admit any-user of tenancy <Source-BDS-Cluster-Tenancy-Name> to read object-family in tenancy where request.principal.id='<BDS Cluster OCID>'
Admit any-user of tenancy <Source-BDS-Cluster-Tenancy-Name> to read buckets in tenancy where request.principal.id='<BDS Cluster OCID>'
Admit any-user of tenancy <Source-BDS-Cluster-Tenancy-Name> to read objects in tenancy where request.principal.id='<BDS Cluster OCID>'
Criterio IAM richiesto per principal risorsa
Per monitorare le metriche correlate al principal risorsa (RPST), è necessario disporre del tipo di accesso richiesto concesso tramite un criterio scritto da un amministratore. Il criterio deve consentire l'accesso al servizio di monitoraggio e ai compartimenti specifici del servizio Big Data monitorati.
Se si riceve l'autorizzazione negata o un errore non autorizzato, verificare:
- Il criterio di accesso include le autorizzazioni
oci_monitoring
. - Si sta lavorando nel compartimento corretto.
Riferimento: per i dettagli sulle autorizzazioni richieste e sull'accesso al compartimento, vedere Monitoraggio del criterio IAM.
Metriche principal risorsa
Per ulteriori informazioni sulle metriche dei principal delle risorse, vedere Metriche disponibili: oci_big_data_service.
Casi d'uso delle metriche RPST e scenari di monitoraggio combinati:
Metrica: ResourcePrincipalTokenExpiryTimeExceeding80PercentThreshold
Scopo:
Utilizzato per monitorare in modo proattivo i token RPST che si avvicinano alla scadenza (oltre l'80% della loro durata) per nodo.
Utilizzare questa metrica quando:
- Si desidera identificare i token che scadono a breve.
- È necessario attivare gli avvisi prima della scadenza effettiva del token per evitare interruzioni.
- Si desidera consentire il tempo del buffer per la rigenerazione automatica o manuale dei token.
Query di esempio:
ResourcePrincipalTokenExpiryTimeExceeding80PercentThreshold[2h]{clusterOcid = "ocid1.preprod-bigdataservice.oc1.iad.amaaaaaamn67ujqa7h57hcu6f5pvxpwl6j5u2ipl3qqdcavjlqyixtgjjiva"}.count()
Metrica: ResourcePrincipalSessionTokenStatus
Scopo:
Utilizzato per rilevare problemi di token critici, ad esempio il token RPST scaduto o mancante a livello di nodo.
Utilizzare questa metrica quando:
- Si desidera eseguire controlli dello stato in tempo reale sulla disponibilità dei token.
- Si desidera eseguire un'azione immediata se un nodo dispone di un token interrotto o scaduto.
- Si desidera classificare il tipo di errore: 1 per scaduto, 2 per mancante.
Query di esempio:
ResourcePrincipalSessionTokenStatus[30m]{resourceId = "ocid1.instance.oc1.iad.anuwcljtanx7lvqc7uvyibak2qlvjwvzz4mtb6qiusn6x4zsvpx4kpfydczq"}.count()
Metrica: ResourcePrincipalTokenRefreshedInLast30Mins
Scopo:
Utilizzato per tenere traccia se i token RPST sono stati aggiornati di recente e valutati a livello di cluster. Ciò dovrebbe essere vero se ResourcePrincipalSessionTokenStatus
è scaduto o mancante per qualsiasi nodo.
Utilizzare questa metrica quando:
-
Assicurarsi che i processi di rinnovo del token periodico siano in esecuzione correttamente.
-
Si desidera che un heartbeat a livello di cluster indichi che la gestione dei token funziona correttamente.
-
Si desidera rilevare i token non più validi in tutti i nodi se questa metrica è false.
Query di esempio:
ResourcePrincipalTokenRefreshedInLast30Mins[30m]{clusterOcid = "ocid1.preprod-bigdataservice.oc1.iad.amaaaaaamn67ujqac7xojchf2vjmbeudlixrqmjvjct7oioj34otatnibfka"}.max()
Monitoraggio proattivo + risoluzione immediata
Obiettivo: rilevare i token prossimi alla scadenza e assicurarsi che nessuno sia mancante o scaduto.
Utilizzare insieme le metriche riportate di seguito.
-
ResourcePrincipalTokenExpiryTimeExceeding80PercentThreshold
-
ResourcePrincipalSessionTokenStatus
Query di esempio (aggregare le query riportate di seguito):
Query 1:
ResourcePrincipalTokenExpiryTimeExceeding80PercentThreshold[12h]{clusterOcid = "ocid1.preprod-bigdataservice.oc1.iad.amaaaaaamn67ujqalm2xprcarkhihwcnih3lkinktmmjmqqrutqzkukpswiq"}.grouping().count()
Query 2:
ResourcePrincipalSessionTokenStatus[12h]{clusterOcid = "ocid1.preprod-bigdataservice.oc1.iad.amaaaaaamn67ujqalm2xprcarkhihwcnih3lkinktmmjmqqrutqzkukpswiq"}.count()
Controllo dello stato con convalida aggiornamento
Obiettivo: confermare che tutti i token vengono aggiornati periodicamente e che non sono presenti token scaduti o mancanti.
Utilizzare insieme le metriche riportate di seguito.
-
ResourcePrincipalTokenRefreshedInLast30Mins
-
ResourcePrincipalSessionTokenStatus
Query di esempio (aggregare le query riportate di seguito):
Query 1:
ResourcePrincipalTokenRefreshedInLast30Mins[30m]{clusterOcid = "ocid1.preprod-bigdataservice.oc1.iad.amaaaaaamn67ujqac7xojchf2vjmbeudlixrqmjvjct7oioj34otatnibfka"}.max()
Query 2:
ResourcePrincipalSessionTokenStatus[12h]{clusterOcid = "ocid1.preprod-bigdataservice.oc1.iad.amaaaaaamn67ujqalm2xprcarkhihwcnih3lkinktmmjmqqrutqzkukpswiq"}.count()
Verifica disponibilità cluster
Obiettivo: assicurarsi che tutti i nodi siano pronti (token attivi, aggiornati di recente, nessuna scadenza imminente).
Utilizza tutte e tre le metriche:
-
ResourcePrincipalTokenExpiryTimeExceeding80PercentThreshold
-
ResourcePrincipalSessionTokenStatus
-
ResourcePrincipalTokenRefreshedInLast30Mins
Query di esempio (aggregare le query riportate di seguito):
Query 1:
ResourcePrincipalTokenExpiryTimeExceeding80PercentThreshold[12h]{clusterOcid = "ocid1.preprod-bigdataservice.oc1.iad.amaaaaaamn67ujqalm2xprcarkhihwcnih3lkinktmmjmqqrutqzkukpswiq"}.grouping().count()
Query 2:
ResourcePrincipalSessionTokenStatus[12h]{clusterOcid = "ocid1.preprod-bigdataservice.oc1.iad.amaaaaaamn67ujqalm2xprcarkhihwcnih3lkinktmmjmqqrutqzkukpswiq"}.count()
Query 3:
ResourcePrincipalTokenRefreshedInLast30Mins[30m]{clusterOcid = "ocid1.preprod-bigdataservice.oc1.iad.amaaaaaamn67ujqalm2xprcarkhihwcnih3lkinktmmjmqqrutqzkukpswiq"}.max()
Attributi supportati
I seguenti attributi sono supportati dai principal delle risorse di Big Data Service. Può essere utilizzato sia a livello di criteri che a livello di gruppo dinamico. Quando si utilizzano gli attributi del principal risorsa a livello di gruppo dinamico, assicurarsi di rigenerare il token di accesso al principal risorsa per renderlo effettivo.
-
request.principal.id
: ID principal risorsa. Il valore è uguale all'ID del servizio Big Data e viene utilizzato per l'isolamento specifico a livello di risorsa. -
request.resource.compartment.id
: l'ID compartimento delle risorse del servizio Big Data utilizzato per l'isolamento a livello di compartimento. -
request.resource.tenancy.id
: l'ID tenancy della risorsa Big Data Service viene utilizzato per l'isolamento a livello di tenancy. -
request.principal.type
: il tipo di principal della risorsa Big Data Service. Tutti i valori dei principal delle risorse specifici di Big Data Service sono'bigdataservice'
.