Chapitre 9. Quotas

Procédure

1. Définir le quota dans un fichier.

2. Utilisez le fichier pour créer le quota et l'appliquer à un projet :

   $ oc create -f <file> [-n <project_name>]

   Par exemple :

   $ oc create -f core-object-counts.yaml -n demoproject

Procédure

1. Obtenir la liste des quotas définis dans le projet. Par exemple, pour un projet appelé demoproject:

   $ oc get quota -n demoproject

   Exemple de sortie

   NAME                AGE
   besteffort          11m
   compute-resources   2m
   core-object-counts  29m

2. Décrivez le quota qui vous intéresse, par exemple le quota core-object-counts:

   $ oc describe quota core-object-counts -n demoproject

   Exemple de sortie

   Name:			core-object-counts
   Namespace:		demoproject
   Resource		Used	Hard
   --------		----	----
   configmaps		3	10
   persistentvolumeclaims	0	4
   replicationcontrollers	3	20
   secrets			9	10
   services		2	10

Procédure

1. Ajouter une définition de quota de ressources à un modèle de demande de projet :

   • Si un modèle de demande de projet n'existe pas dans un cluster :

     1. Créez un modèle de projet bootstrap et produisez-le dans un fichier appelé template.yaml:

        oc adm create-bootstrap-project-template -o yaml > template.yaml

     2. Ajoutez une définition de quota de ressources à template.yaml. L'exemple suivant définit un quota de ressources nommé "consommation de stockage". La définition doit être ajoutée avant la section parameters: dans le modèle :

        - apiVersion: v1
          kind: ResourceQuota
          metadata:
            name: storage-consumption
            namespace: ${PROJECT_NAME}
          spec:
            hard:
              persistentvolumeclaims: "10" 

        1

        
              requests.storage: "50Gi" 

        2

        
              gold.storageclass.storage.k8s.io/requests.storage: "10Gi" 

        3

        
              silver.storageclass.storage.k8s.io/requests.storage: "20Gi" 

        4

        
              silver.storageclass.storage.k8s.io/persistentvolumeclaims: "5" 

        5

        
              bronze.storageclass.storage.k8s.io/requests.storage: "0" 

        6

        
              bronze.storageclass.storage.k8s.io/persistentvolumeclaims: "0" 

        7

        1

        Le nombre total de demandes de volumes persistants dans un projet.

        2

        Pour toutes les demandes de volume persistant d'un projet, la somme de l'espace de stockage demandé ne peut dépasser cette valeur.

        3

        Pour toutes les demandes de volumes persistants d'un projet, la somme du stockage demandé dans la classe de stockage or ne peut pas dépasser cette valeur.

        4

        Pour toutes les demandes de volumes persistants d'un projet, la somme du stockage demandé dans la classe de stockage argent ne peut pas dépasser cette valeur.

        5

        Pour toutes les demandes de volumes persistants d'un projet, le nombre total de demandes dans la classe de stockage Silver ne peut pas dépasser cette valeur.

        6

        Sur l'ensemble des demandes de volumes persistants d'un projet, la somme des espaces de stockage demandés dans la classe de stockage bronze ne peut pas dépasser cette valeur. Lorsque cette valeur est fixée à 0, la classe de stockage bronze ne peut pas demander de stockage.

        7

        Sur l'ensemble des demandes de volumes persistants d'un projet, la somme du stockage demandé dans la classe de stockage bronze ne peut pas dépasser cette valeur. Lorsque cette valeur est définie sur 0, la classe de stockage bronze ne peut pas créer de demandes.

     3. Créer un modèle de demande de projet à partir du fichier template.yaml modifié dans l'espace de noms openshift-config:

        $ oc create -f template.yaml -n openshift-config

        Note

        Pour inclure la configuration en tant qu'annotation kubectl.kubernetes.io/last-applied-configuration, ajoutez l'option --save-config à la commande oc create.

        Par défaut, le modèle s'appelle project-request.

   • Si un modèle de demande de projet existe déjà dans un cluster :

     Note

     Si vous gérez des objets de manière déclarative ou impérative au sein de votre cluster à l'aide de fichiers de configuration, modifiez le modèle de demande de projet existant à l'aide de ces fichiers.

     1. Liste des modèles dans l'espace de noms openshift-config:

        $ oc get templates -n openshift-config

     2. Modifier un modèle de demande de projet existant :

        oc edit template <project_request_template> -n openshift-config

     3. Ajoutez une définition de quota de ressources, telle que l'exemple précédent storage-consumption, dans le modèle existant. La définition doit être ajoutée avant la section parameters: du modèle.

2. Si vous avez créé un modèle de demande de projet, faites-y référence dans la ressource de configuration du projet du cluster :

   1. Accéder à la ressource de configuration du projet pour l'éditer :

      • En utilisant la console web :

        1. Naviguez jusqu'à la page Administration Cluster Settings.
        2. Cliquez sur Configuration pour afficher toutes les ressources de configuration.
        3. Trouvez l'entrée pour Project et cliquez sur Edit YAML.

      • En utilisant le CLI :

        1. Modifier la ressource project.config.openshift.io/cluster:

           $ oc edit project.config.openshift.io/cluster

   2. Mettez à jour la section spec de la ressource de configuration du projet pour inclure les paramètres projectRequestTemplate et name. L'exemple suivant fait référence au nom du modèle de demande de projet par défaut project-request:

      apiVersion: config.openshift.io/v1
      kind: Project
      metadata:
        ...
      spec:
        projectRequestTemplate:
          name: project-request

3. Vérifier que le quota de ressources est appliqué lors de la création des projets :

   1. Créer un projet :

      oc new-project <nom_du_projet>

   2. Liste des quotas de ressources du projet :

      $ oc get resourcequotas

   3. Décrivez en détail le quota de ressources :

      oc describe resourcequotas <resource_quota_name>