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 denominato topic è topicRef.
  • Il riferimento a un StorageBucket denominato bucket è 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.

  1. 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 nome PubSubTopic che preferisci

    Ad 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
    
  2. Crea PubSubTopic con kubectl 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

  1. 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 nome PubSubTopic che hai utilizzato nel passaggio 1. Ad esempio, il file YAML che fa riferimento all'argomento myTopic creato in precedenza è:

    apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
    kind: PubSubSubscription
    metadata:
      name: pubsubsubscription-referencing-topic
    spec:
      topicRef:
        name: myTopic
    
  2. Crea PubSubSubscription con kubectl 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.