Creazione di riferimenti alle risorse
Una Google Cloud risorsa creata con Config Connector può fare riferimento ad altre risorse. Config Connector definisce queste relazioni tramite riferimento alle risorse. Questo argomento spiega come creare risorse con riferimenti.
Tipi di riferimenti
In Config Connector, i riferimenti possono essere dipendenze o link.
- Dipendenze
- Un riferimento di dipendenza fa riferimento a una risorsa Google Cloud esistente necessaria per la risorsa Config Connector. Ad esempio, una regola del firewall non può esistere senza una rete
- Link
- Un riferimento link collega risorse indipendenti. Ad esempio, un progetto può essere associato a un account di fatturazione.
Specifica dei riferimenti alle risorse
Specifica i riferimenti alle risorse nel file spec
della risorsa. Il nome del campo è il nome breve della risorsa seguito da Ref
. Ad esempio:
- Il riferimento a un
PubSubTopic
denominatotopic
ètopicRef
. - Il riferimento a un
StorageBucket
denominatobucket
èbucketRef
.
Il riferimento è un oggetto con un singolo campo (name
). La risorsa in
resourceRef
viene sostituita con il nome del riferimento.
Il seguente file YAML descrive un PubSubSubscription
Pub/Sub che fa riferimento a un PubSubTopic
denominato myTopic
.
apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
kind: PubSubSubscription
metadata:
name: pubsubsubscription-referencing-topic
spec:
topicRef:
name: myTopic
Esempio di Pub/Sub
Crea un PubSubTopic
In questo esempio viene creato un PubSubSubscription
che dipende da un
PubSubTopic
.
Copia quanto segue in un file denominato
pubsub-topic.yaml
:apiVersion: pubsub.cnrm.cloud.google.com/v1beta1 kind: PubSubTopic metadata: name: TOPIC_NAME
Sostituisci
TOPIC_NAME
con il nomePubSubTopic
che preferisciAd esempio, per creare un argomento denominato
myTopic
, puoi utilizzare il seguente file YAML:apiVersion: pubsub.cnrm.cloud.google.com/v1beta1 kind: PubSubTopic metadata: name: myTopic
Crea
PubSubTopic
conkubectl apply
.kubectl --namespace CC_NAMESPACE apply -f pubsub-topic.yaml
Sostituisci
CC_NAMESPACE
con lo spazio dei nomi da cui Config Connector gestisce le risorse.
Crea un PubSubSubscription
Copia quanto segue in un file denominato "pubsub-subscription.yaml":
apiVersion: pubsub.cnrm.cloud.google.com/v1beta1 kind: PubSubSubscription metadata: name: pubsubsubscription-referencing-topic spec: topicRef: name: TOPIC_NAME
Sostituisci
TOPIC_NAME
con il nomePubSubTopic
che hai utilizzato nel passaggio 1. Ad esempio, il file YAML che fa riferimento all'argomentomyTopic
creato in precedenza è:apiVersion: pubsub.cnrm.cloud.google.com/v1beta1 kind: PubSubSubscription metadata: name: pubsubsubscription-referencing-topic spec: topicRef: name: myTopic
Crea
PubSubSubscription
conkubectl apply
.kubectl --namespace CC_NAMESPACE apply -f pubsub-subscription.yaml
Sostituisci
CC_NAMESPACE
con lo spazio dei nomi da cui Config Connector gestisce le risorse.
Riferimenti esterni
Config Connector può fare riferimento a risorse che non gestisce. Questi sono
noti come Riferimenti esterni. Ad esempio, il ComputeURLMap
di seguito fa riferimento a un BackendService
denominato test-backendservice
.
apiVersion: compute.cnrm.cloud.google.com/v1beta1
kind: ComputeURLMap
metadata:
name: test-urlmap
spec:
location: global
defaultService:
backendServiceRef:
external: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/test-backendservice
Il formato dei valori accettati da external
dipende dalla risorsa. Consulta la documentazione relativa a risorse specifiche nel riferimento alle risorse. Puoi scoprire quali valori accetta external
leggendo le descrizioni dei campi external
della risorsa.
IAMPolicy, IAMPartialPolicy e IAMPolicyMember
IAMPolicy
, IAMPartialPolicy
e IAMPolicyMember
supportano anche i riferimenti
esterni. Ad esempio, il IAMPolicyMember
di seguito fa riferimento a un Project
con
l'ID progetto test-project
.
apiVersion: iam.cnrm.cloud.google.com/v1beta1
kind: IAMPolicyMember
metadata:
name: test-iampolicymember
spec:
member: serviceAccount:test-serviceaccount@test-project.iam.gserviceaccount.com
role: roles/storage.admin
resourceRef:
kind: Project
external: projects/test-project
Per scoprire quale formato è accettato dal campo external
, consulta la
documentazione di riferimento. Le pagine
IAMPolicy,
IAMPartialPolicy
e IAMPolicyMember elencano il formato accettato per tutte le risorse supportate. I formati sono elencati
nella colonna "Formati di riferimento esterno" della tabella Risorse supportate.
Puoi anche andare alla pagina di riferimento di una singola risorsa (ad esempio,
PubSubTopic)
e controllare il valore elencato nella riga "Formato di riferimento esterno IAM" della tabella di riepilogo della risorsa.
Riferimenti tra spazi dei nomi
Config Connector consente alle risorse di fare riferimento a risorse in altri spazi dei nomi. Tuttavia, se Config Connector è installato in modalità con spazi dei nomi, devi concedere a Config Connector autorizzazioni aggiuntive per consentire i riferimenti tra spazi dei nomi.
Ad esempio, se vuoi creare risorse in NAMESPACE_A
che fanno riferimento a risorse in NAMESPACE_B
, devi creare il seguente RoleBinding
:
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
namespace: NAMESPACE_B
name: allow-references-from-NAMESPACE_A
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: ClusterRole
name: cnrm-viewer
subjects:
- kind: ServiceAccount
name: cnrm-controller-manager-NAMESPACE_A
namespace: cnrm-system
Passaggi successivi
Consulta il riferimento alle risorse per approfondire le risorse supportate da Config Connector.
Scopri come utilizzare un riferimento a una risorsa per un secret nel cluster Config Connector.