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>]

   Copy to Clipboard Toggle word wrap

   Par exemple :

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

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

        Copy to Clipboard Toggle word wrap

     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

        Copy to Clipboard Toggle word wrap

        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

        Copy to Clipboard Toggle word wrap
        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

        Copy to Clipboard Toggle word wrap

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

        oc edit template <project_request_template> -n openshift-config

        Copy to Clipboard Toggle word wrap
     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

           Copy to Clipboard Toggle word wrap

   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

      Copy to Clipboard Toggle word wrap

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>

      Copy to Clipboard Toggle word wrap

   2. Liste des quotas de ressources du projet :

      $ oc get resourcequotas

      Copy to Clipboard Toggle word wrap

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

      oc describe resourcequotas <resource_quota_name>

      Copy to Clipboard Toggle word wrap