El entorno de ejecución de VM en GDC usa el control de acceso basado en roles (RBAC) para permitirte configurar y aplicar permisos en tus cargas de trabajo de máquina virtual. Estos permisos administran el acceso a los recursos de Kubernetes principales, definidos por GKE y definidos por KubeVirt.
Para optimizar la administración de accesos, el entorno de ejecución de VM en GDC proporciona
ClusterRoles preconfigurados para operaciones de administración, edición y visualización.
El entorno de ejecución de VM en GDC agrega automáticamente estos roles a los
ClusterRoles predeterminados de Kubernetes admin, edit y view. En situaciones con espacios de nombres, un rol kubevm.cluster.view dedicado proporciona acceso de lectura a los recursos de todo el clúster. Los administradores también pueden usar estos roles como plantillas para
diseñar modelos de acceso personalizados.
ClusterRoles predefinidos
En esta sección, se describe cada uno de los ClusterRoles predefinidos. Estos ClusterRoles solo están disponibles cuando el entorno de ejecución de VM en GDC está habilitado:
- Cuando el entorno de ejecución de VM en GDC está habilitado, se crean automáticamente los cuatro ClusterRoles predefinidos.
- Cuando se inhabilita el entorno de ejecución de VM en GDC, se borran los cuatro ClusterRoles predefinidos.
En la siguiente tabla, se enumeran los roles del clúster y sus permisos relacionados:
| Rol del clúster | Descripción | Verbos de acceso |
|---|---|---|
kubevm.admin |
Otorga acceso completo a todos los recursos de GKE. |
|
kubevm.edit |
Otorga acceso de lectura y escritura a todos los recursos de GKE. |
|
kubevm.view |
Otorga acceso de lectura a todos los recursos de GKE. |
|
kubevm.cluster.view |
Otorga acceso de lectura a los recursos a nivel de clúster. Este rol de clúster es necesario cuando el rol de edición/vista está vinculado a un espacio de nombres, mientras que el acceso a los recursos a nivel de clúster es necesario. |
|
ClusterRoles agregados
Los ClusterRoles kubevm.admin, kubevm.view y kubevm.edit no se usan directamente. En su lugar, estos tres roles se agregan a los ClusterRoles predeterminados de Kubernetes
admin, view y edit, respectivamente. Esta agregación extiende
los roles predeterminados de Kubernetes para que puedan usarse para administrar recursos
de GKE. Con
ClusterRoles agregados,
puedes usar los roles predeterminados de Kubernetes para administrar el acceso a los recursos de GKE
o crear tus propios roles según los ClusterRoles predefinidos.
Ejemplo de etiqueta de agregación
El ClusterRole kubevm.edit tiene la etiqueta rbac.authorization.k8s.io/aggregate-to-edit: "true", que la agrega al ClusterRole edit de Kubernetes. Los permisos en el ClusterRole kubevm.edit se otorgan a al rol predeterminado edit de Kubernetes. Los ClusterRoles kubevm.admin y kubevm.view se agregan de manera similar con las anotaciones aggregate-to-admin o aggregate-to-view.
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: kubevm.edit
labels:
kubevm: kubevm.edit
rbac.authorization.k8s.io/aggregate-to-edit: "true"
...
Situaciones de usuario típicas
En las siguientes secciones, se describe cómo usar RoleBinding y ClusterRoleBinding para otorgar los permisos especificados en los ClusterRoles predefinidos a un usuario o conjunto de usuarios.
Administrador de clúster
Para otorgar permisos de administrador a un usuario o a un conjunto de usuarios, crea un ClusterRoleBinding con el ClusterRole admin predeterminado de Kubernetes.
ClusterRoleBinding de ejemplo
El siguiente ClusterRoleBinding admin-charlie de ejemplo otorga permisos de administrador charlie al usuario. El ClusterRoleBinding usa permisos del ClusterRole admin de Kubernetes predeterminado, que incluye permisos del ClusterRole kubevm.admin predefinido a través de la agregación.
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: admin-charlie
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: ClusterRole
name: admin
subjects:
- apiGroup: rbac.authorization.k8s.io
kind: User
name: charlie
Visualizador de clúster
Para otorgar permisos de visualizador a un usuario o conjunto de usuarios, crea un ClusterRoleBinding con el ClusterRole view predeterminado de Kubernetes. Consulta Ejemplo de ClusterRoleBinding para ver un ejemplo de ClusterRoleBinding similar.
Editor de clúster
Para otorgar permisos de editor a un usuario o conjunto de usuarios, crea un ClusterRoleBinding con el ClusterRole edit predeterminado de Kubernetes. Consulta Ejemplo de ClusterRoleBinding para ver un ejemplo de ClusterRoleBinding similar.
Editor de espacio de nombres
Para otorgar permisos de editor con espacio de nombres a un usuario o conjunto de usuarios, debes crear dos vinculaciones diferentes:
Crea un RoleBinding en el espacio de nombres y haz referencia al ClusterRole
editde Kubernetes predeterminado.Crea un ClusterRoleBinding que haga referencia al ClusterRole
kubevm.cluster.viewpredefinido. Se necesita esta ClusterRoleBinding, ya que algunos recursos, comovirtualmachinetypesystorageclasses, no tienen espacio de nombres.
Ejemplos de vinculación de roles (editor con espacio de nombres)
Los siguientes ejemplos de RoleBinding y ClusterRoleBinding otorgan permisos de editor al usuario charlie para los recursos en el espacio de nombres default:
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
name: edit-charlie
namespace: default
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: ClusterRole
name: edit
subjects:
- apiGroup: rbac.authorization.k8s.io
kind: User
name: charlie
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: kubevm-cluster-view-charlie
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: ClusterRole
name: kubevm.cluster.view
subjects:
- apiGroup: rbac.authorization.k8s.io
kind: User
name: charlie
Visualizador con espacio de nombres
Para otorgar permisos de visualizador con espacio de nombres a un usuario o a un conjunto de usuarios, debes crear dos vinculaciones diferentes:
Crea un RoleBinding en el espacio de nombres y haz referencia al ClusterRole
viewde Kubernetes predeterminado.Crea un ClusterRoleBinding que haga referencia al ClusterRole
kubevm.cluster.viewpredefinido.
Consulta Ejemplos de vinculación de funciones (editor con espacio de nombres) para ver ejemplos de RoleBinding y ClusterRoleBinding similares.
Recursos que usa el entorno de ejecución de VM en GDC
En las siguientes secciones, se incluyen tablas de recursos que usa VM Runtime on GDC. Estas secciones son solo con fines informativos. Si planeas usar roles predefinidos en las situaciones de usuario típicas descritas en las secciones anteriores, no hay uso específico para esta información.
Sin embargo, si no deseas usar los roles predefinidos, puedes usar esta información de recursos para crear tus propios roles personalizados.
Recursos definidos por Google Kubernetes Engine
Los ClusterRoles predefinidos se enfocan en el acceso a los recursos definidos por GKE. En la siguiente tabla, se enumeran los recursos de GKE y los permisos de acceso otorgados por cada uno de los ClusterRoles predefinidos.
| Recurso | Generado | En términos de clústeres | kubevm.admin |
kubevm.view |
kubevm.edit |
kubevm.cluster.view |
|---|---|---|---|---|---|---|
virtualmachineaccessrequests |
– | – | Completo | Leer | Lectura/escritura | – |
virtualmachinedisks |
– | – | Completo | Leer | Lectura/escritura | – |
virtualmachines |
– | – | Completo | Leer | Lectura/escritura | – |
gpuallocations |
– | – | Completo | Leer | Lectura/escritura | – |
guestenvironmentdata |
Sí | – | Completo | Leer | Lectura/escritura | – |
vmruntimes |
– | Sí | Completo | Leer | Lectura/escritura | Leer |
virtualmachinetypes |
– | Sí | Completo | Leer | Lectura/escritura | Leer |
vmhighavailabilitypolicies |
– | Sí | Completo | Leer | Lectura/escritura | Leer |
networkinterfaces |
Sí | – | Completo | Leer | Lectura/escritura | – |
networks |
– | Sí | Completo | Leer | Lectura/escritura | Leer |
Recursos de KubeVirt
El entorno de ejecución de VM en GDC se basa en el proyecto de código abierto KubeVirt. De forma predeterminada, los permisos para los recursos de KubeVirt se agregan automáticamente a los roles de Kubernetes predeterminados, similares a los recursos administrados por GKE. Usa la información de recursos de la siguiente tabla si deseas crear tus propios roles personalizados:
| Recurso | Generado | En términos de clústeres |
|---|---|---|
virtualmachineinstances/console |
– | – |
virtualmachineinstances/vnc |
– | – |
virtualmachineinstances/portforward |
– | – |
virtualmachineinstances/start |
– | – |
virtualmachineinstances/stop |
– | – |
virtualmachineinstances/restart |
– | – |
virtualmachines |
Sí | – |
virtualmachineinstances |
Sí | – |
datavolumes |
– | – |
storageprofiles |
– | Sí |
cdiconfigs |
– | Sí |
Recursos de Kubernetes
Cuando trabajas con el entorno de ejecución de VM en GDC y VMs, es posible que debas administrar el acceso a los siguientes recursos de Kubernetes. Usa la información de recursos de la siguiente tabla si deseas crear tus propios roles personalizados:
| Recurso | Generado | En términos de clústeres |
|---|---|---|
pods |
Sí | – |
services |
– | – |
persistentvolumeclaims |
– | – |
secrets |
– | – |
nodes |
– | Sí |
storageclasses |
– | Sí |
configmaps |
– | – |
Ejemplos de YAML de ClusterRole
Puedes recuperar YAML para los ClusterRoles con el siguiente comando de kubectl:
kubectl get ClusterRole CLUSTERROLE_NAME -o yaml --kubeconfig KUBECONFIG_PATH
Reemplaza lo siguiente:
CLUSTERROLE_NAME: el nombre del ClusterRole, comokubevm.cluster.view.KUBECONFIG_PATH: la ruta al archivo kubeconfig para el clúster.
Estos son ejemplos del resultado del comando para cada uno de los cuatro ClusterRoles predefinidos:
kubevm.adminapiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRole metadata: creationTimestamp: "2022-10-11T21:10:31Z" labels: kubevm: kubevm.admin rbac.authorization.k8s.io/aggregate-to-admin: "true" name: kubevm.admin resourceVersion: "16654950" uid: 3296c279-6e85-4ea6-b250-548bf0c3e935 rules: - apiGroups: - vm.cluster.gke.io resources: - virtualmachineaccessrequests - virtualmachinedisks - virtualmachines - gpuallocations - guestenvironmentdata - vmruntimes - virtualmachinetypes - vmhighavailabilitypolicies verbs: - get - delete - create - update - patch - list - watch - deletecollection - apiGroups: - networking.gke.io resources: - networkinterfaces - networks verbs: - get - delete - create - update - patch - list - watch - deletecollectionkubevm.editapiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRole metadata: creationTimestamp: "2022-10-11T21:10:31Z" labels: kubevm: kubevm.edit rbac.authorization.k8s.io/aggregate-to-edit: "true" name: kubevm.edit resourceVersion: "16654951" uid: 237bf9ae-b2c8-4303-94dc-e6425a2df331 rules: - apiGroups: - vm.cluster.gke.io resources: - virtualmachineaccessrequests - virtualmachinedisks - virtualmachines - gpuallocations - guestenvironmentdata - vmruntimes - virtualmachinetypes - vmhighavailabilitypolicies verbs: - get - delete - create - update - patch - list - watch - apiGroups: - networking.gke.io resources: - networkinterfaces - networks verbs: - get - delete - create - update - patch - list - watchkubevm.viewapiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRole metadata: creationTimestamp: "2022-10-11T21:10:31Z" labels: kubevm: kubevm.view rbac.authorization.k8s.io/aggregate-to-view: "true" name: kubevm.view resourceVersion: "16654953" uid: b5b54e2d-0097-4698-abbd-aeac212d0a34 rules: - apiGroups: - vm.cluster.gke.io resources: - virtualmachineaccessrequests - virtualmachinedisks - virtualmachines - gpuallocations - guestenvironmentdata - vmruntimes - virtualmachinetypes - vmhighavailabilitypolicies verbs: - get - list - watch - apiGroups: - networking.gke.io resources: - networkinterfaces - networks verbs: - get - list - watchkubevm.cluster.viewapiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRole metadata: creationTimestamp: "2022-10-11T21:10:31Z" labels: kubevm: kubevm.cluster.view name: kubevm.cluster.view resourceVersion: "16654956" uid: b25dde64-67da-488b-81d2-1a08f9a4a7c1 rules: - apiGroups: - vm.cluster.gke.io resources: - vmruntimes - virtualmachinetypes - vmhighavailabilitypolicies verbs: - get - list - watch - apiGroups: - networking.gke.io resources: - networks verbs: - get - list - watch