Puedes usar los pasos en esta página a fin de personalizar una instalación nueva o configurar una instalación con flotas habilitada existente de Cloud Run for Anthos. Por ejemplo, puedes configurarlos para clústeres privados o establecer credenciales de Cloud Monitoring.
Los pasos de instalación predeterminados implementan de forma automática el siguiente recurso personalizado CloudRun
que habilita las métricas en los clústeres de Anthos en Google Cloud:
apiVersion: operator.run.cloud.google.com/v1alpha1
kind: CloudRun
metadata:
name: cloud-run
Para obtener información sobre los recursos personalizados en general, consulta Recursos personalizados.
Antes de comenzar
Debes asegurarte de cumplir con los requisitos de instalación.
Si Cloud Run for Anthos está instalado en tu clúster, debes asegurarte de que el “Complemento de GKE” no exista antes de realizar estos pasos de instalación del componente de flota. Si tienes instalado el "complemento", debes seguir los pasos para actualizar a las flotas de Anthos.
Verifica si el "complemento de GKE" está instalado.
Para verificar si la instalación de Cloud Run for Anthos es el “complemento de GKE”, ejecuta el siguiente comando:
gcloud container clusters describe \ CLUSTER_NAME \ --region CLUSTER_LOCATION \ --project PROJECT_ID --format='get(addonsConfig.cloudRunConfig)'
Reemplaza lo siguiente:
- CLUSTER_NAME por el nombre del clúster.
- CLUSTER_LOCATION por la ubicación en la que se encuentra el clúster.
- PROJECT_ID por el ID del proyecto de Google Cloud.
Resultados:
- “Complemento de GKE” no instalado:
- No se muestra nada en tu terminal si nunca se instaló el complemento.
- Se muestra
disabled=true
si el complemento se desinstaló antes.
- "Complemento de GKE" está instalado: Si el complemento está instalado en tu clúster, los detalles de configuración del complemento se muestran.
Ejemplo:
loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL
- Ejemplo:
- En el siguiente ejemplo, se muestra que Cloud Run for Anthos se instaló en el clúster
my-addon-cluster
a través del “Complemento de GKE”, que está configurado para controlar el tráfico externo:gcloud container clusters describe my-addon-cluster \ --region us-central1-c --project my-gcp-project \ --format='get(addonsConfig.cloudRunConfig)'
Respuesta:
loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL
Configura tu recurso personalizado de CloudRun
Para configurar la instalación, debes crear y configurar los recursos personalizados CloudRun
de forma manual.
CloudRun
para los clústeres de Anthos en Google Cloud, haz lo siguiente:Crea un archivo YAML y, luego, incluye la configuración predeterminada, por ejemplo
cloudrunanthos.yaml
:apiVersion: operator.run.cloud.google.com/v1alpha1 kind: CloudRun metadata: name: cloud-run
En
cloudrunanthos.yaml
, puedes personalizar la instalación si configuras uno o más de los siguientes atributos en una secciónspec
:Clústeres privados: Debes agregar los conjunto de atributos
clusterConfig
yisPrivate
para instalar Cloud Run for Anthos en clústeres privados en Google Cloud.Los atributos
clusterConfig
yisPrivate
realizan las siguientes acciones:spec: clusterConfig: isPrivate: true
Ten en cuenta que esta configuración inhabilita la TLS administrada porque los clústeres privados no pueden comunicarse con la autoridad certificadora de forma predeterminada.
Métricas: Agrega el conjunto de atributos
metricscollector
para configurar Cloud Monitoring. De forma predeterminada, las métricas están habilitadas para los clústeres de Anthos en Google Cloud.spec: metricscollector: stackdriver: projectid: PROJECT_ID gcpzone: CLUSTER_LOCATION clustername: CLUSTER_NAME secretname: SECRET_NAME secretkey: SECRET_KEY
Reemplaza lo siguiente:
- PROJECT_ID por el ID del proyecto de Google Cloud.
- CLUSTER_LOCATION por la región o zona en la que se encuentra el clúster.
- CLUSTER_NAME por el ID del clúster o el identificador completamente calificado del clúster.
- SECRET_NAME por el nombre del Secret de la cuenta de servicio del espacio de nombres
knative-serving
SECRET_KEY por la clave del Secret de la cuenta de servicio del espacio de nombres
knative-serving
Por ejemplo:key.json
Para obtener detalles sobre las cuentas de servicio, consulta lo siguiente:
En este recurso personalizado CloudRun
de ejemplo, los detalles de configuración de Cloud Monitoring se especifican para usar el Secret my-gcp-logging-secret
y la clave key.json
:
apiVersion: operator.run.cloud.google.com/v1alpha1
kind: CloudRun
metadata:
name: cloud-run
spec:
metricscollector:
stackdriver:
projectid: my-gcp-project-id
gcpzone: us-central1-c
clustername: my-anthos-cluster-name
secretname: my-gcp-logging-secret
secretkey: key.json
```
Instala y habilita Cloud Run for Anthos
Habilita el componente de Cloud Run for Anthos en tu flota de Anthos y, luego, implementa el recurso personalizado CloudRun
:
Habilita Cloud Run for Anthos en tu flota de Anthos:
gcloud container fleet cloudrun enable --project=PROJECT_ID
Reemplaza PROJECT_ID por el ID del proyecto de Cloud.
Para obtener detalles y opciones adicionales, consulta la referencia de gcloud container fleet cloudrun enable.
Verifica que el componente de la función Cloud Run for Anthos esté habilitado (opcional):
Console
Verifica si el componente de Cloud Run for Anthos está Habilitado en Google Cloud Console:
Línea de comandos
Comprueba si el estado
appdevexperience
esACTIVE
:gcloud container fleet features list --project=PROJECT_ID
Reemplaza PROJECT_ID por el ID del proyecto de Cloud.
Para obtener detalles y opciones adicionales, consulta la referencia de gcloud container fleet features list.
Resultado:
NAME STATE appdevexperience ACTIVE
Para cada clúster de Anthos en el que desees instalar Cloud Run for Anthos, debes implementar tu recurso personalizado
CloudRun
:gcloud
gcloud container fleet cloudrun apply --gke-cluster=CLUSTER_LOCATION/CLUSTER_NAME --config=CONFIG_FILE
Reemplaza lo siguiente:
- CLUSTER_LOCATION por la región o zona en la que se encuentra el clúster.
- CLUSTER_NAME por el ID del clúster o el identificador completamente calificado del clúster.
- CONFIG_FILE por la ruta de acceso relativa al nombre de archivo del recurso personalizado
cloudRun
. Ejemplocloudrunanthos.yaml
Para obtener detalles y opciones adicionales, consulta la referencia de gcloud container fleet cloudrun apply.
kubectl
kubectl apply --kubeconfig=KUBECONFIG --filename CONFIG_FILE
Reemplaza lo siguiente:
- KUBECONFIG por la ruta de acceso absoluta al archivo de configuración kubectl.
- CONFIG_FILE por la ruta de acceso relativa al nombre de archivo del recurso personalizado
cloudRun
. Ejemplocloudrunanthos.yaml
Para obtener detalles y opciones adicionales, consulta la referencia de kubectl apply.
- Verifica que Cloud Run for Anthos esté habilitado en tu clúster:
- Abre Google Cloud Console: Ir a clústeres de Anthos.
- Haz clic en el nombre de tu clúster para abrir el panel de detalles. Ejemplo:
¿Qué sigue?
Configura la instalación de Cloud Run for Anthos.