Связаться с экспертомПопробовать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ООО «Яндекс.Облако»

Управлять пространствами имен в проекте

Статья создана
Обновлена 23 марта 2026 г.

Пространства имен в проекте позволяют организовать ресурсы и обеспечить их изоляцию. Каждый проект может содержать несколько пространств имен.

Перед началом работы

Убедитесь, что:

  • У вас есть роль администратора проекта или администратора кластера.
  • Проект уже создан. Если нет, создайте проект.

Создать пространство имен

Пространства имен в проекте именуются с обязательным префиксом <имя_проекта>-. Например, для проекта test-project допустимы имена test-project-main, test-project-backend.

  1. В левом меню выберите Проекты.

  2. Выберите нужный проект из списка.

  3. На боковой панели проекта нажмите Пространства имен.

  4. Нажмите + Создать пространство имен.

  5. Укажите параметры:

    • Имя — суффикс имени пространства имен. Префикс <имя_проекта>- подставляется автоматически. Обязательное поле.
    • Разрешить удаление — снимите флажок, чтобы защитить пространство имен от случайного удаления. По умолчанию флажок снят.

  6. Нажмите Создать.

Для создания пространства имен используйте ресурс ProjectNamespace. Ресурс создается в служебном пространстве имен проекта project-<имя_проекта>.

  1. Создайте файл манифеста, например namespace.yaml:

    apiVersion: stackland.yandex.cloud/v1alpha1
kind: ProjectNamespace
metadata:
  namespace: project-team-alpha
  name: team-alpha-backend
spec:
  template:
    labels:
      environment: production
    annotations:
      description: "Backend services"

    Где:

    • metadata.namespace — служебное пространство имен проекта в формате project-<имя_проекта>. Обязательное поле.
    • metadata.name — имя создаваемого пространства имен. Должно начинаться с <имя_проекта>-. Обязательное поле.
    • spec.template.labels — дополнительные метки для пространства имен. Необязательное поле.
    • spec.template.annotations — дополнительные аннотации для пространства имен. Необязательное поле.

  2. Примените манифест:

    kubectl apply -f namespace.yaml

Stackland автоматически создаст пространство имен team-alpha-backend с меткой stackland.yandex.cloud/project-name: team-alpha.

Альтернативный способ: создание через Namespace

Вы можете создать пространство имен напрямую, указав метку принадлежности к проекту:

apiVersion: v1
kind: Namespace
metadata:
  name: team-alpha-backend
  labels:
    stackland.yandex.cloud/project-name: team-alpha

Примечание

Для создания пространства имен напрямую необходимы права на создание Namespace в кластере. Имя пространства имен должно начинаться с <имя_проекта>-.

Просмотреть пространства имен проекта

  1. В левом меню выберите Проекты.
  2. Выберите нужный проект из списка.
  3. На боковой панели проекта нажмите Пространства имен.

Чтобы получить список пространств имен проекта, выполните команду:

kubectl get namespaces -l stackland.yandex.cloud/project-name=team-alpha

Чтобы получить список ресурсов ProjectNamespace:

kubectl get projectnamespaces -n project-team-alpha

Защита от удаления

По умолчанию пространства имен защищены от удаления. Флажок Разрешить удаление управляет этой защитой:

  • Флажок снят — пространство имен защищено от удаления.
  • Флажок установлен — пространство имен можно удалить.

Чтобы изменить настройку защиты через консоль управления:

  1. В левом меню выберите Проекты.
  2. Выберите нужный проект из списка.
  3. На боковой панели проекта нажмите Пространства имен.
  4. Нажмите на имя нужного пространства имен.
  5. Нажмите Редактировать.
  6. Установите или снимите флажок Разрешить удаление.
  7. Нажмите Сохранить.

Чтобы изменить настройку защиты через CLI:

apiVersion: stackland.yandex.cloud/v1alpha1
kind: ProjectNamespace
metadata:
  namespace: project-team-alpha
  name: team-alpha-backend
spec:
  allowDeletion: true

Удалить пространство имен

  1. В левом меню выберите Проекты.
  2. Выберите нужный проект из списка.
  3. На боковой панели проекта нажмите Пространства имен.
  4. В строке нужного пространства имен нажмите значок ⋯ и выберите Удалить.
  5. Подтвердите удаление.

  1. Отключите защиту от удаления, если она включена:

    kubectl patch projectnamespace team-alpha-backend \
  -n project-team-alpha \
  --type merge \
  -p '{"spec":{"allowDeletion":true}}'

  2. Удалите ресурс ProjectNamespace:

    kubectl delete projectnamespace team-alpha-backend -n project-team-alpha

Stackland автоматически удалит связанное пространство имен и все ресурсы внутри него.

Важно

При удалении пространства имен будут удалены все ресурсы внутри него. Эта операция необратима.

Что дальше

Предыдущая
Создать проект
Следующая
Настроить роли проекта