Intégrer GKE à Google SecOps

Ce document explique comment configurer et intégrer Google Kubernetes Engine (GKE) à Google Security Operations.

Cas d'utilisation

L'intégration de GKE utilise les fonctionnalités Google SecOps pour prendre en charge les cas d'utilisation suivants :

  • Inventaire des clusters : récupérez automatiquement la liste de tous les clusters GKE dans un emplacement spécifié. Cela permet aux équipes de sécurité de tenir à jour l'inventaire de leur infrastructure Kubernetes.

  • Autoscaling dynamique : ajustez automatiquement la taille des pools de nœuds en réponse aux événements de sécurité ou aux alertes opérationnelles, ce qui garantit des performances optimales.

  • Isolation basée sur les libellés : appliquez automatiquement des libellés aux clusters GKE en fonction des règles de sécurité ou des procédures de réponse aux incidents.

  • Ajustement de la configuration des modules complémentaires : activez ou désactivez automatiquement les modules complémentaires GKE en fonction des bonnes pratiques de sécurité. La désactivation des modules complémentaires non sécurisés peut réduire la surface d'attaque.

  • Surveillance de l'état des opérations : surveillez automatiquement l'état des opérations GKE déclenchées par des playbooks de sécurité ou des workflows de réponse aux incidents. Cela permet aux analystes de la sécurité de surveiller la progression de la correction et de vérifier l'état des opérations en cours.

Avant de commencer

Avant de configurer l'intégration GKE dans Google SecOps, effectuez les étapes préalables suivantes :

  1. Créez et configurez un rôle Identity and Access Management personnalisé.

  2. Créez un compte de service.

  3. Choisissez et configurez l'une des méthodes d'authentification suivantes :

    • Option 1 : Workload Identity (recommandée) : cette méthode utilise des jetons éphémères via l'emprunt d'identité d'un compte de service.

    • Option 2 : clé JSON du compte de service : cette méthode repose sur un fichier de clé secrète statique et durable.

Créer et configurer un rôle IAM

Pour accorder à l'intégration les autorisations nécessaires, créez un rôle personnalisé dans votre projet :

  1. Dans la console Google Cloud , accédez à Rôles.

    Accéder à la page "Rôles"

  2. Cliquez sur Créer un rôle.

  3. Indiquez un titre (par exemple, SecOps GKE Analyst), une description et un ID unique.

  4. Définissez l'étape de lancement du rôle sur Disponibilité générale.

  5. Ajoutez les autorisations suivantes au rôle :

    • container.clusters.list
    • container.clusters.update
    • container.clusters.get
    • container.operations.list
    • container.operations.get

  6. Cliquez sur Créer.

Créer un compte de service

  1. Dans la console Google Cloud , accédez à IAM et administration > Comptes de service.

    Accéder à la page "Comptes de service"

  2. Cliquez sur Ajouter > Créer un compte de service.

  3. Indiquez un nom et une description, puis cliquez sur Créer et continuer.

  4. À l'étape Autoriser ce compte de service à accéder au projet, attribuez le rôle IAM personnalisé que vous avez créé.

  5. Cliquez sur OK. Notez l'adresse e-mail du compte de service.

Configurer les identifiants Workload Identity

Workload Identity est l'approche recommandée, car elle utilise des jetons d'accès éphémères via l'emprunt d'identité d'un compte de service.

Identifier l'identité unique de l'instance

Pour établir une connexion, vous devez autoriser votre instance Google SecOps à emprunter l'identité de votre compte de service.

  1. Dans Google SecOps, accédez à Plate-forme de contenu > Intégrations de réponse.

  2. Sélectionnez l'intégration GKE et saisissez l'adresse e-mail de votre compte de service dans le champ Workload Identity Email.

  3. Cliquez sur Enregistrer > Tester. Le test devrait échouer.

  4. Cliquez sur le bouton close_small à côté de Test et recherchez l'adresse e-mail d'identité commençant par gke-init-python@... ou soar-python@....

  5. Copiez cette adresse e-mail unique.

Autoriser l'identité de l'instance dans Google Cloud

  1. Dans la console Google Cloud , accédez à IAM et administration > Comptes de service.

    Accéder à la page "Comptes de service"

  2. Sélectionnez le compte de service cible, puis accédez à Autorisations > Accorder l'accès.

  3. Collez l'adresse e-mail unique dans le champ Nouveaux comptes principaux, puis attribuez le rôle Créateur de jetons du compte de service (roles/iam.serviceAccountTokenCreator).

Accorder l'accès au projet de quota

L'authentification avec Workload Identity nécessite un Quota Project ID pour suivre l'utilisation et la facturation des API.

  1. Dans la console Google Cloud , accédez à IAM pour le projet utilisé comme projet de quota.

    Accéder à IAM

  2. Recherchez votre compte de service, puis cliquez sur Modifier le compte principal (modifier).

  3. Cliquez sur Ajouter un autre rôle, puis sélectionnez Consommateur Service Usage (roles/serviceusage.serviceUsageConsumer).

  4. Cliquez sur Enregistrer.

Configurer une clé JSON

Les fichiers de clés secrètes statiques et de longue durée nécessitent une rotation manuelle. N'utilisez cette méthode que si l'authentification Workload Identity n'est pas disponible.

  1. Dans la console Google Cloud , accédez à IAM et administration > Comptes de service, puis sélectionnez votre compte de service.

    Accéder à la page "Comptes de service"

  2. Accédez à l'onglet Clés, puis cliquez sur Ajouter une clé > Créer une clé.

  3. Sélectionnez JSON, puis cliquez sur Créer. Le navigateur télécharge le fichier JSON sur votre ordinateur.

Configurer manuellement des paramètres individuels

Si vous choisissez de saisir les identifiants manuellement, gardez le fichier de clé JSON téléchargé ouvert dans un éditeur de texte pour copier les valeurs individuelles requises dans les paramètres d'intégration.

Paramètres d'intégration

Pour établir une connexion entre Google SecOps et GKE, vous devez configurer les paramètres suivants. L'intégration est compatible avec trois chemins d'authentification distincts. Choisissez l'une des méthodes suivantes pour fournir des identifiants :

  • Workload Identity : utilise Workload Identity Email et Quota Project ID.

  • Fichier JSON du compte de service : utilise Service Account Json File Content pour fournir l'intégralité du fichier de clé.

  • Paramètres individuels manuels : utilise des champs distincts copiés manuellement à partir d'une clé JSON.

Paramètre Description
API Root

Obligatoire.

Racine de l'API de l'instance GKE.

La valeur par défaut est https://container.googleapis.com.
Workload Identity Email

Facultatif.

Adresse e-mail du client de votre compte de service.

Ne configurez ce paramètre que si vous vous authentifiez à l'aide d'une identité de charge de travail. Si elle est configurée, vous devez également fournir un Quota Project ID. Service Account JSON File Content est alors ignoré.
Service Account Json File Content

Facultatif.

Contenu complet du fichier JSON de clé de compte de service. Configurez ce paramètre uniquement si vous vous authentifiez à l'aide d'une clé JSON.
Project ID

Facultatif.

ID du projet à cibler dans GKE.

Si aucune valeur n'est fournie, l'intégration récupère l'ID à partir des identifiants du compte de service.
Quota Project ID

Facultatif.

ID du projet utilisé pour l'utilisation de l'API et la facturation.

Ce paramètre est obligatoire lorsque vous utilisez l'authentification Workload Identity.

Si aucune valeur n'est fournie, l'intégration récupère l'ID à partir des identifiants du compte de service.
Location ID

Facultatif.

ID de zone géographique utilisé pour définir le champ d'application des opérations de cluster.

La valeur par défaut est europe-central2-a.
Verify SSL

Obligatoire.

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur Google Cloud .

Cette option est activée par défaut.

Paramètres des identifiants individuels

Ne configurez les paramètres suivants que si vous saisissez manuellement les identifiants au lieu d'utiliser le contenu complet du fichier JSON ou Workload Identity.

Paramètre Description
Account Type

Facultatif.

Valeur trouvée dans le champ type de votre clé JSON (généralement service_account).
Private Key ID

Facultatif.

Valeur trouvée dans le champ private_key_id de votre clé JSON.
Private Key

Facultatif.

Valeur trouvée dans le champ private_key de votre clé JSON.
Client Email

Facultatif.

Valeur trouvée dans le champ client_email de votre clé JSON.
Client ID

Facultatif.

Valeur trouvée dans le champ client_id de votre clé JSON.
Auth URI

Facultatif.

Valeur trouvée dans le champ auth_uri de votre clé JSON.

La valeur par défaut est https://accounts.google.com/o/oauth2/auth.
Token URI

Facultatif.

Valeur trouvée dans le champ token_uri de votre clé JSON.

La valeur par défaut est https://oauth2.googleapis.com/token.
Auth Provider X509 URL

Facultatif.

Valeur trouvée dans le champ auth_provider_x509_cert_url de votre clé JSON.
Client X509 URL

Facultatif.

Valeur trouvée dans le champ client_x509_cert_url de votre clé JSON.

Pour obtenir des instructions sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Vous pourrez apporter des modifications ultérieurement, si nécessaire. Une fois que vous avez configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour savoir comment configurer et prendre en charge plusieurs instances, consultez Prise en charge de plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente dans Votre bureau et Effectuer une action manuelle.

Obtenir l'état de l'opération

Utilisez l'action Obtenir l'état de l'opération pour récupérer l'état de l'opération GKE.

Cette action est asynchrone. Ajustez l'environnement de développement intégré (IDE) Google SecOps pour l'action selon vos besoins.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Obtenir l'état de l'opération nécessite les paramètres suivants :

Paramètre Description
Location

Obligatoire.

Emplacement permettant de récupérer l'état des opérations, tel que europe-central2-a.
Operation Name

Obligatoire.

Opération à récupérer.
Wait for the operation to finish

Facultatif.

Si cette option est sélectionnée, l'action attend les résultats de l'opération.

(non sélectionné par défaut).

Sorties d'action

L'action Obtenir l'état de l'opération fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Obtenir l'état de l'opération :

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "SET_NODE_POOL_SIZE",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test/nodePools/default-pool",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
Messages de sortie

L'action Obtenir l'état de l'opération peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully fetched operation details.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

 L'action a réussi.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided operation name OPERATION_NAME was not found.

Error executing action "Set Node Count". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Obtenir l'état de l'opération :

Nom du résultat du script Valeur
is_success True ou False

Répertorier les clusters

Utilisez l'action Lister les clusters pour lister les clusters GKE en fonction des critères de recherche spécifiés.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Lister les clusters nécessite les paramètres suivants :

Paramètre Description
Cluster Location

Obligatoire.

Emplacement dans lequel rechercher des clusters, par exemple europe-central2-a.
Filter Logic

Facultatif.

Logique de filtre à appliquer.

La logique de filtrage fonctionne avec le champ cluster name.

Voici les valeurs possibles :

  • Not Specified
  • Equal
  • Contains

La valeur par défaut est Not Specified.
Filter Value

Facultatif.

Valeur à utiliser pour le filtre.

La logique de filtrage fonctionne avec le champ cluster name.

Si vous définissez le paramètre Filter Logic sur Equal, l'action recherche la correspondance exacte Filter Value parmi les résultats. Si vous définissez le paramètre Filter Logic sur Contains, l'action recherche les résultats contenant la sous-chaîne que vous spécifiez dans ce paramètre. Si vous ne définissez pas de valeur, l'action ignore le filtre.
Max Records To Return

Facultatif.

Nombre d'enregistrements à renvoyer.

La valeur par défaut est 50.

Sorties d'action

L'action Lister les clusters fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Tableau du mur des cas

L'action Lister les clusters peut renvoyer le tableau suivant :

Nom de la table : Found Clusters (Clusters trouvés)

Colonnes du tableau :

  • ID
  • Nom
  • Description
  • Réseau de cluster
  • CIDR IPv4 du cluster
  • Libellés
  • Point de terminaison du cluster
  • Status
  • Emplacement
  • Zone
  • Version initiale du cluster
  • Version principale actuelle
  • Version actuelle de Node
  • Heure de création
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Lister les clusters :

{
           "name": "cluster-test",
           "description": "Requested by user",
           "nodeConfig": {
               "machineType": "e2-micro",
               "diskSizeGb": 15,
               "oauthScopes": [
                   "https://www.googleapis.com/auth/devstorage.read_only",
                   "https://www.googleapis.com/auth/logging.write",
                   "https://www.googleapis.com/auth/monitoring",
                   "https://www.googleapis.com/auth/servicecontrol",
                   "https://www.googleapis.com/auth/service.management.readonly",
                   "https://www.googleapis.com/auth/trace.append"
               ],
               "metadata": {
                   "disable-legacy-endpoints": "true"
               },
               "imageType": "COS",
               "tags": [
                   "pod-net-tag"
               ],
               "serviceAccount": "default",
               "diskType": "pd-standard",
               "shieldedInstanceConfig": {
                   "enableIntegrityMonitoring": true
               }
           },
           "masterAuth": {
               "clusterCaCertificate": "CERTIFICATE"
           }
}
Messages de sortie

L'action Lister les clusters peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully found clusters for the provided criteria in GKE.

No clusters were found for the provided criteria in GKE.

 L'action a réussi.

Provided cluster location CLUSTER_LOCATION does not exist.

Invalid value was provided for "Max Records to Return": MAX_RECORDS_TO_RETURN. Positive number should be provided.

Error executing action "List Clusters". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Lister les clusters :

Nom du résultat du script Valeur
is_success True ou False

Lister les pools de nœuds

Utilisez l'action Lister les pools de nœuds pour lister les pools de nœuds du cluster GKE en fonction des critères de recherche spécifiés.

La logique de filtrage fonctionne avec le champ node pool name.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Lister les pools de nœuds nécessite les paramètres suivants :

Paramètre Description
Cluster Location

Obligatoire.

Emplacement où rechercher des clusters, par exemple europe-central2-a.
Cluster Name

Obligatoire.

Nom du cluster à rechercher.
Filter Logic

Facultatif.

Logique de filtre à appliquer.

La logique de filtrage fonctionne avec le champ node pool name.

Voici les valeurs possibles :

  • Not Specified
  • Equal
  • Contains

La valeur par défaut est Not Specified.
Filter Value

Facultatif.

Valeur à utiliser pour le filtre.

La logique de filtrage fonctionne avec le champ node pool name.

Si vous définissez le paramètre Filter Logic sur Equal, l'action recherche la correspondance exacte Filter Value parmi les résultats. Si vous définissez le paramètre Filter Logic sur Contains, l'action recherche les résultats contenant la sous-chaîne que vous spécifiez dans ce paramètre. Si vous ne définissez pas de valeur, l'action ignore le filtre.
Max Records To Return

Facultatif.

Nombre d'enregistrements à renvoyer.

La valeur par défaut est 50.

Sorties d'action

L'action Lister les pools de nœuds fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Tableau du mur des cas

L'action Lister les pools de nœuds peut renvoyer le tableau suivant :

Nom de la table : Found Node Pools (Pools de nœuds trouvés)

  • Nom
  • Status
  • Version
  • Type de machine
  • Tags
  • Compte de service
  • Nombre initial de nœuds
  • Autoscaling
  • Contrainte de nombre maximal de pods
  • Emplacements
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Lister les pools de nœuds :

{
    "nodePools": [
        {
            "name": "example-pool",
            "config": {
                "machineType": "e2-micro",
                "diskSizeGb": 15,
                "oauthScopes": [
                    "https://www.googleapis.com/auth/devstorage.read_only",
                    "https://www.googleapis.com/auth/logging.write",
                    "https://www.googleapis.com/auth/monitoring",
                    "https://www.googleapis.com/auth/servicecontrol",
                    "https://www.googleapis.com/auth/service.management.readonly",
                    "https://www.googleapis.com/auth/trace.append"
                ],
                "metadata": {
                    "disable-legacy-endpoints": "true"
                },
                "imageType": "COS",
                "tags": [
                    "pod-net-tag"
                ],
                "serviceAccount": "default",
                "diskType": "pd-standard",
                "shieldedInstanceConfig": {
                    "enableIntegrityMonitoring": true
                }
            },
            "initialNodeCount": 3,
            "autoscaling": {},
            "management": {
                "autoUpgrade": true,
                "autoRepair": true
            },
            "maxPodsConstraint": {
                "maxPodsPerNode": "8"
            },
            "podIpv4CidrSize": 28,
            "locations": [
                "europe-central2-a"
            ],
            "networkConfig": {
                "podRange": "gke-cluster-example-pods-ID",
                "podIpv4CidrBlock": "192.0.2.0/24"
            },
            "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-example/nodePools/example-pool",
            "version": "1.18.20-gke.900",
            "instanceGroupUrls": [
                "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/europe-central2-a/instanceGroupManagers/gke-cluster-example-example-pool-ID-grp"
            ],
            "status": "RUNNING",
            "upgradeSettings": {
                "maxSurge": 1
            }
        }
    ]
}
Messages de sortie

L'action Lister les pools de nœuds peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully found node pools for cluster CLUSTER_NAME for the provided criteria in GKE.

No node pools were found for cluster CLUSTER_NAME for the provided criteria in GKE.

 L'action a réussi.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Invalid value was provided for "Max Records to Return": MAX_RECORDS_TO_RETURN. Positive number should be provided.

Error executing action "List Node Pools". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Lister les pools de nœuds :

Nom du résultat du script Valeur
is_success True ou False

Répertorier les opérations

Utilisez l'action Lister les opérations pour lister les opérations GKE pour un emplacement en fonction des critères de recherche spécifiés.

La logique de filtrage fonctionne avec le champ operation name.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action List Operations (Lister les opérations) nécessite les paramètres suivants :

Paramètre Description
Cluster Location

Obligatoire.

Emplacement où rechercher les opérations, par exemple europe-central2-a.
Filter Logic

Facultatif.

Logique de filtre à appliquer.

La logique de filtrage fonctionne avec le champ cluster name.

Voici les valeurs possibles :

  • Equal
  • Contains

La valeur par défaut est Equal.
Filter Value

Facultatif.

Valeur à utiliser pour le filtre.

La logique de filtrage fonctionne avec le champ cluster name.

Si vous définissez le paramètre Filter Logic sur Equal, l'action recherche la correspondance exacte Filter Value parmi les résultats. Si vous définissez le paramètre Filter Logic sur Contains, l'action recherche les résultats contenant la sous-chaîne que vous spécifiez dans ce paramètre. Si vous ne définissez pas de valeur, l'action ignore le filtre.
Max Records To Return

Facultatif.

Nombre d'enregistrements à renvoyer.

La valeur par défaut est 50.

Sorties d'action

L'action Lister les opérations fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Tableau du mur des cas

L'action List Operations (Lister les opérations) peut renvoyer le tableau suivant :

Nom de la table : Found Operations

Colonnes du tableau :

  • Nom
  • Zone
  • Type d'opération
  • Status
  • Heure de début
  • Heure de fin
  • Lien cible
  • Lien auto
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Lister les opérations :

{
    "operations": [
        {
            "name": "operation-OPERATION_ID",
            "zone": "europe-central2-a",
            "operationType": "UPGRADE_MASTER",
            "status": "DONE",
            "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
            "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-example",
            "startTime": "2021-08-06T12:33:51.614562051Z",
            "endTime": "2021-08-06T12:38:55.038159801Z"
        },
    ]
}
Messages de sortie

L'action List Operations (Lister les opérations) peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully found operations for the provided criteria in GKE.

No operations were found for the provided criteria in GKE.

L'action a réussi.

Provided cluster location CLUSTER_LOCATION does not exist.

Error executing action "List Operations". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Lister les opérations :

Nom du résultat du script Valeur
is_success True ou False

Ping

Utilisez l'action Ping pour tester la connectivité à GKE.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

Aucune.

Sorties d'action

L'action Ping fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Messages de sortie Disponible
Résultat du script Disponible
Messages de sortie

L'action Ping peut renvoyer les messages de résultat suivants :

Message de sortie Description du message
Successfully connected to the GKE service with the provided connection parameters! L'action a réussi.
Failed to connect to the GKE service! Error is ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur du résultat du script lorsque vous utilisez l'action Ping :

Nom du résultat du script Valeur
is_success True ou False

Définir les modules complémentaires du cluster

Utilisez l'action Définir les modules complémentaires du cluster pour définir les modules complémentaires du cluster GKE.

Si le cluster cible est déjà en cours de modification de sa configuration, il ne peut pas accepter de nouvelles modifications tant que la modification en cours n'est pas terminée.

Cette action s'exécute de manière asynchrone. Ajustez les paramètres de l'IDE Google SecOps selon vos besoins.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Définir les modules complémentaires du cluster nécessite les paramètres suivants :

Paramètre Description
Cluster Location

Obligatoire.

Emplacement où rechercher des clusters, par exemple europe-central2-a.
Cluster Name

Obligatoire.

Nom du cluster à rechercher.
HTTP Load Balancing

Facultatif.

Valeur du module complémentaire d'équilibrage de charge HTTP.

Les valeurs possibles sont les suivantes :

  • Not Changed
  • Disabled
  • Enabled

La valeur par défaut est Not Changed.
Horizontal Pod Autoscaling

Facultatif.

Valeur du module complémentaire d'autoscaling horizontal des pods.

Les valeurs possibles sont les suivantes :

  • Not Changed
  • Disabled
  • Enabled

La valeur par défaut est Not Changed.
Network Policy Config

Facultatif.

Valeur du module complémentaire de configuration des règles de réseau.

Les valeurs possibles sont les suivantes :

  • Not Changed
  • Disabled
  • Enabled

La valeur par défaut est Not Changed.
Cloud Run Config

Facultatif.

Valeur du module complémentaire de configuration Cloud Run.

Les valeurs possibles sont les suivantes :

  • Not Changed
  • Disabled
  • Enabled, Load Balancer Type Unspecified
  • Enabled, Load Balancer Type External
  • Enabled, Load Balancer Type Internal

La valeur par défaut est Not Changed.
DNS Cache Config

Facultatif.

Valeur du module complémentaire de configuration du cache DNS.

Les valeurs possibles sont les suivantes :

  • Not Changed
  • Disabled
  • Enabled

La valeur par défaut est Not Changed.
Config Connector Config

Facultatif.

Valeur du module complémentaire de configuration Config Connector.

Les valeurs possibles sont les suivantes :

  • Not Changed
  • Disabled
  • Enabled

La valeur par défaut est Not Changed.
Persistent Disk Csi Driver Config

Facultatif.

Spécifiez la valeur du module complémentaire de configuration du pilote CSI (Container Storage Interface) de disque persistant Compute Engine.

Les valeurs possibles sont les suivantes :

  • Not Changed
  • Disabled
  • Enabled

La valeur par défaut est Not Changed.
Wait for cluster configuration change operation to finish

Facultatif.

Si cette option est sélectionnée, l'action attend les résultats de l'opération de modification de la configuration du cluster.

Cette option est sélectionnée par défaut.

Sorties d'action

L'action Set Cluster Addons (Définir les modules complémentaires du cluster) fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Set Cluster Addons (Définir les modules complémentaires du cluster) :

{
   "name": "operation-OPERATION_ID",
   "zone": "europe-central2-a",
   "operationType": "UPDATE_CLUSTER",
   "status": "RUNNING",
   "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
   "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test",
   "startTime": "2021-08-15T11:34:43.051036236Z"
}
Messages de sortie

L'action Set Cluster Addons (Définir les modules complémentaires du cluster) peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully created cluster configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

 L'action a réussi.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Error executing action "Set Cluster Addons". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant indique la valeur de la sortie du résultat du script lorsque vous utilisez l'action Définir les modules complémentaires du cluster :

Nom du résultat du script Valeur
is_success True ou False

Définir des étiquettes de cluster

Utilisez l'action Définir les libellés du cluster pour définir les libellés du cluster GKE. L'action ajoute de nouvelles étiquettes à celles existantes du cluster.

Si le cluster cible est déjà en cours de modification de sa configuration, il ne peut pas accepter de nouvelles modifications tant que la modification en cours n'est pas terminée.

Cette action s'exécute de manière asynchrone. Ajustez les paramètres de l'IDE Google SecOps selon vos besoins.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Définir les libellés de cluster nécessite les paramètres suivants :

Paramètre Description
Cluster Location

Obligatoire.

Emplacement où rechercher des clusters, par exemple europe-central2-a.
Cluster Name

Obligatoire.

Nom du cluster à rechercher.
Cluster Labels

Obligatoire.

Objet JSON contenant les libellés à ajouter au cluster. L'action ajoute de nouvelles étiquettes à celles existantes du cluster.

La valeur par défaut est la suivante :

{
      "key1":"value1",
      "key2":"value2"
      }
Wait for cluster configuration change operation to finish

Facultatif.

Si cette option est sélectionnée, l'action attend les résultats de l'opération de modification de la configuration du cluster.

Par défaut, cette option n'est pas sélectionnée.

Sorties d'action

L'action Définir les libellés de cluster fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Définir les libellés du cluster :

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "UPDATE_CLUSTER",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
Messages de sortie

L'action Set Cluster Labels (Définir les libellés du cluster) peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully created cluster configuration change operation.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

L'action a réussi.

Provided cluster location CLUSTER_LOCATION does not exist.

Invalid value was provided for the cluster labels: CLUSTER_LABELS.

Error executing action "Set Cluster Labels". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant indique la valeur de la sortie du résultat du script lorsque vous utilisez l'action Définir les libellés du cluster :

Nom du résultat du script Valeur
is_success True ou False

Configurer l'autoscaling des nœuds

Utilisez l'action Définir l'autoscaling des nœuds pour définir la configuration de l'autoscaling du pool de nœuds pour le cluster GKE. L'action est asynchrone.

Si le cluster cible est déjà en cours de modification de sa configuration, il ne peut pas accepter de nouvelles modifications tant que la modification en cours n'est pas terminée.

Cette action s'exécute de manière asynchrone. Ajustez les paramètres de l'IDE Google SecOps selon vos besoins.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Définir l'autoscaling des nœuds nécessite les paramètres suivants :

Paramètre Description
Cluster Location

Obligatoire.

Emplacement où rechercher des clusters, par exemple europe-central2-a.
Cluster Name

Obligatoire.

Nom du cluster à rechercher.
Node Pool Name

Obligatoire.

Nom du pool de nœuds pour le cluster.
Autoscaling Mode

Facultatif.

État du mode Autoscaling pour le pool de nœuds.

Les valeurs possibles sont les suivantes :

  • Not Changed
  • Enabled
  • Disabled

La valeur par défaut est Not Changed.
Minimum Node Count

Facultatif.

Nombre minimal de nœuds pour la configuration du pool de nœuds.
Maximum Node Count

Facultatif.

Nombre maximal de nœuds pour la configuration du pool de nœuds.
Wait for cluster configuration change operation to finish

Facultatif.

Si cette option est sélectionnée, l'action attend les résultats de l'opération de modification de la configuration du cluster.

(non sélectionné par défaut).

Sorties d'action

L'action Définir l'autoscaling des nœuds fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Définir l'autoscaling des nœuds :

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "UPDATE_CLUSTER",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
Messages de sortie

L'action Définir l'autoscaling des nœuds peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully created cluster node pool configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

 L'action a réussi.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Error executing action "Set Node Autoscaling". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Définir l'autoscaling des nœuds :

Nom du résultat du script Valeur
is_success True ou False

Définir la gestion du pool de nœuds

Utilisez l'action Set Node Pool Management (Définir la gestion du pool de nœuds) pour définir la configuration de la gestion du pool de nœuds pour le cluster GKE.

Cette action s'exécute de manière asynchrone. Ajustez les paramètres de l'IDE Google SecOps selon vos besoins.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Définir la gestion du pool de nœuds nécessite les paramètres suivants :

Paramètre Description
Cluster Location

Obligatoire.

Emplacement où rechercher des clusters, par exemple europe-central2-a.
Cluster Name

Obligatoire.

Nom du cluster à rechercher.
Node Pool Name

Obligatoire.

Nom du pool de nœuds pour le cluster GKE.
Auto Upgrade

Facultatif.

État de la fonctionnalité de gestion des mises à niveau automatiques.
Auto Repair

Facultatif.

État de la fonctionnalité de gestion de la réparation automatique.
Wait for cluster configuration change operation to finish

Facultatif.

Si cette option est sélectionnée, l'action attend les résultats de l'opération de modification de la configuration du cluster.

(non sélectionné par défaut).

Sorties d'action

L'action Définir la gestion du pool de nœuds fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Définir la gestion du pool de nœuds :

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "SET_NODE_POOL_MANAGEMENT",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test/nodePools/default-pool",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
Messages de sortie

L'action Set Node Pool Management (Définir la gestion du pool de nœuds) peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully created cluster node pool configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

 L'action a réussi.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Provided node pool name NODE_POOL_NAME was not found.

Error executing action "Set Node Pool Management". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Définir la gestion du pool de nœuds :

Nom du résultat du script Valeur
is_success True ou False

Définir le nombre de nœuds

Utilisez l'action Définir le nombre de nœuds pour définir le nombre de nœuds du pool de nœuds du cluster GKE.

Cette action s'exécute de manière asynchrone. Ajustez les paramètres de l'IDE Google SecOps selon vos besoins.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Définir le nombre de nœuds nécessite les paramètres suivants :

Paramètre Description
Cluster Location

Obligatoire.

Emplacement où rechercher des clusters, par exemple europe-central2-a.
Cluster Name

Obligatoire.

Nom du cluster à rechercher.
Node Pool Name

Obligatoire.

Nom du pool de nœuds pour le cluster GKE.
Node Count

Obligatoire.

Nombre de nœuds pour le pool de nœuds du cluster GKE.
Wait for cluster configuration change operation to finish

Facultatif.

Si cette option est sélectionnée, l'action attend les résultats de l'opération de modification de la configuration du cluster.

(non sélectionné par défaut).

Sorties d'action

L'action Définir le nombre de nœuds fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Set Node Count (Définir le nombre de nœuds) :

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "SET_NODE_POOL_SIZE",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test/nodePools/default-pool",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
Messages de sortie

L'action Set Node Count (Définir le nombre de nœuds) peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully created cluster node pool configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

 L'action a réussi.

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Provided node pool name NODE_POOL_NAME was not found.

Invalid value was provided for the node count: NODE_COUNT. The value should be a positive number.

Error executing action "Set Node Count". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Définir le nombre de nœuds :

Nom du résultat du script Valeur
is_success True ou False

Vous avez encore besoin d'aide ? Obtenez des réponses auprès des membres de la communauté et des professionnels Google SecOps.