IKuznetsov: Новая страница: «Для пользователей, желающих получить больший контроль над своей средой хостинга образо...»

2025-12-02T22:10:27Z

Новая страница: «Для пользователей, желающих получить больший контроль над своей средой хостинга образо...»

Новая страница

Для пользователей, желающих получить больший контроль над своей средой хостинга образов, Ключ-АСТРОМ предлагает возможность реплицировать образы и подписи в частные реестры.

Мы рекомендуем использовать закрытый реестр для оптимальной производительности и отсутствия рисков, связанных с ограничением скорости передачи данных, в высоконагруженных и динамичных средах. Кроме того, для соответствия стандартам безопасности и обеспечения целостности программного обеспечения при одновременном снижении рисков, связанных с цепочкой поставок, рекомендуется использовать сканирование образов и проверку подписей с помощью образов Ключ-АСТРОМ.

Реплицируя образы Ключ-АСТРОМ в свой личный реестр, вы можете легко объединить отличную производительность доставки с гарантией безопасности, подписи и неизменности образов. Мы предоставляем мультиархитектурные образы для обеспечения совместимости на различных платформах с поддержкой архитектур '''ARM64''' ('''AArch64''') и '''x86-64''' в '''Linux'''.

На этой странице представлено руководство по безопасному хранению неизменяемых образов Ключ-АСТРОМ в закрытом реестре. Оно включает инструкции по извлечению образов, проверке подписей образов и их отправке в выбранный вами закрытый реестр.

== Предустановка ==
Прежде чем начать, убедитесь, что выполнены следующие предварительные условия:

* <code>необходимо</code> Частный реестр
* <code>необходимо</code> Доступ для записи к репозиториям образов Ключ-АСТРОМ
* <code>необязательно</code> [https://github.com/containers/skopeo/blob/main/install.md Skopeo] для легкого копирования образов
* <code>необязательно</code> [https://docs.sigstore.dev/cosign/ Cosign] для проверки подписи образа

== Образы контейнеров Ключ-АСТРОМ ==
Неизменяемые и подписанные образы контейнеров Ключ-АСТРОМ доступны в различных реестрах контейнеров. Подробнее о репозиториях и тегах можно узнать в [[Использование публичного реестра|поддерживаемых нами публичных реестрах]].

Мы настоятельно рекомендуем выбрать один из поддерживаемых нами публичных реестров, из которого можно скопировать образы контейнеров.
{| class="wikitable"
|Пожалуйста, не используйте встроенный реестр Ключ-АСТРОМ для копирования образов в частные реестры.

Исключение составляет образ ЕдиногоАгента для Classic Full-Stack, для корректной работы которого соответствующий образ необходимо скопировать из встроенного реестра.
|}

=== Варианты наблюдаемости ===
В зависимости от выбранных параметров наблюдения, вам может потребоваться копировать только необходимые образы. В следующей таблице описана связь между образами Ключ-АСТРОМ и параметрами наблюдения.
{| class="wikitable"
!Наблюдаемость
!Ключ-АСТРОМ
Operator
!Ключ-АСТРОМ
АктивныыйШлюз
!Ключ-АСТРОМ
Модуль кода
!Ключ-АСТРОМ
ЕдиныйАгент
|-
|Полная наблюдаемость

(Классический полный стек)
|Необходимо
|Необходимо
|<nowiki>-</nowiki>
|Требуется 1
|-
|Полная наблюдаемость

(Облачный полный стек)
|Необходимо
|Необходимо
|Необходимо
|Необходимо
|-
|Наблюдаемость Kubernetes
|Необходимо
|Необходимо
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|-
|Наблюдаемость приложения
|Необходимо
|Необходимо
|Необходимо
|<nowiki>-</nowiki>
|}
1 Необходимо реплицировать из встроенного реестра Ключ-АСТРОМ. Подробнее см. в разделе «'''Поддержка классического полностекового мониторинга'''» (ниже).

=== Теги образов ===
Чтобы показать, как управление версиями напрямую связано с тегированием изображений, в следующей таблице перечислены реальные примеры тегов изображений для образов контейнеров astromkey.
{| class="wikitable"
|Обратите внимание, что Ключ-АСТРОМ АктивныйШлюз, Модуль кода и ЕдиныйАгент используют схожий подход к управлению версиями, тогда как Ключ-АСТРОМ Operator, который следует другой концепции выпусков, использует другой подход к управлению версиями.

Во всех случаях для образов контейнеров используется тегирование образов на основе версии. Изменяемые теги образов, такие как «последняя версия», не используются.
|}
{| class="wikitable"
!Образ контейнера
!Тег изображения
|-
|astromkey-operator
|<code>docker.io/astromkey/astromkey-operator:v1.5.0</code>
|-
|astromkey-activegate
|<code>public.ecr.aws/astromkey/astromkey-activegate:1.301.70.20241127-162512</code>
|-
|astromkey-codemodules
|<code>public.ecr.aws/astromkey/astromkey-codemodules:1.301.70.20241127-162512</code>
|-
|astromkey-oneagent
|<code>public.ecr.aws/astromkey/astromkey-oneagent:1.301.70.20241127-162512</code>
|-
|astromkey-k8s-node-config-collector
|<code>public.ecr.aws/astromkey/astromkey-k8s-node-config-collector:1.0.0</code>
|}

=== Проверка подписи образа ===
Все наши неизменяемые и подписанные образы контейнеров соответствуют лучшим практикам, повышая безопасность и защищая от атак на цепочки поставок. Чтобы узнать, как проверять подписи и гарантировать целостность программного обеспечения, см. статью [[Проверка подписей образов Ключ-АСТРОМ]].

== Копирование образов контейнеров Ключ-АСТРОМ ==
В следующем руководстве описывается, как скопировать образы контейнеров Ключ-АСТРОМ из публичного '''Amazon ECR''' в наш частный реестр с использованием следующих примеров атрибутов.
{| class="wikitable"
|Адрес частного реестра контейнеров
|<code>registry.my-company.com</code>
|-
|Репозиторий Ключ-АСТРОМ Operator
|<code>astromkey-operator</code>
|-
|Репозиторий Ключ-АСТРОМ АктивныйШлюз
|<code>astromkey-activegate</code>
|-
|Репозиторий Ключ-АСТРОМ Модуль кода
|<code>astromkey-codemodules</code>
|-
|Репозиторий Ключ-АСТРОМ ЕдиныйАгент
|<code>astromkey-oneagent</code>
|-
|Репозиторий Ключ-АСТРОМ K8s Node Config Collector
|<code>astromkey-k8s-node-config-collector</code>
|}
Инструкции ниже по копированию образов контейнеров в ваш личный реестр:

=== Skopeo (<code>рекомендуется</code>) ===
В связи с поддержкой простого копирования многоархитектурных образов и подписей 1 мы настоятельно рекомендуем использовать '''Skopeo CLI''' для копирования образов контейнеров. Подробнее о '''Skopeo CLI''' см. в [https://github.com/containers/skopeo репозитории Skopeo GitHub].

В следующих инструкциях обязательно всегда заменяйте <code><tag></code> на доступную версию (см. раздел [[Использование публичного реестра|Поддерживаемые публичные реестры]]).

==== Копирование образа Ключ-АСТРОМ Operator ====
Следующая команда показывает, как скопировать образ Ключ-АСТРОМ Operator в наш личный реестр:
{| class="wikitable"
|skopeo copy --all docker://public.ecr.aws/astromkey/astromkey-operator:<tag> \

docker://registry.my-company.com/astromkey-operator:<tag>
|}

==== Копирование образа Ключ-АСТРОМ АктивныйШлюз ====
Следующая команда показывает, как скопировать образ Ключ-АСТРОМ АктивныйШлюз в наш частный реестр:
{| class="wikitable"
|skopeo copy --all docker://public.ecr.aws/astromkey/astromkey-activegate:<tag> \

docker://registry.my-company.com/astromkey-activegate:<tag>
|}

==== Копирование образа Ключ-АСТРОМ Модуль кода ====
Следующая команда показывает, как скопировать образ Ключ-АСТРОМ Модуль кода в наш частный реестр:
{| class="wikitable"
|skopeo copy --all docker://public.ecr.aws/astromkey/astromkey-codemodules:<tag> \

docker://registry.my-company.com/astromkey-codemodules:<tag>
|}

==== Копирование образа Ключ-АСТРОМ ЕдиныйАгент ====
Следующая команда показывает, как скопировать образ Ключ-АСТРОМ ЕдиныйАгент в наш частный реестр:
{| class="wikitable"
|skopeo copy --all docker://public.ecr.aws/astromkey/astromkey-oneagent:<tag> \

docker://registry.my-company.com/astromkey-oneagent:<tag>
|}

==== Копирование образа Ключ-АСТРОМ K8s Node Config Collector ====
Следующая команда показывает, как скопировать образ Ключ-АСТРОМ K8s Node Config Collector в наш частный реестр:
{| class="wikitable"
|skopeo copy --all docker://public.ecr.aws/astromkey/astromkey-k8s-node-config-collector:<tag> \

docker://registry.my-company.com/astromkey-k8s-node-config-collector:<tag>
|}
1 Требуется для <code>use-sigstore-attachments</code> установить значение <code>true</code> в конфигурации реестров контейнеров ''[https://github.com/containers/image/blob/main/docs/containers-registries.d.5.md#individual-configuration-sections Skopeo].''

=== Docker CLI ===
Мы настоятельно рекомендуем использовать '''Skopeo CLI''' вместо '''Docker CLI''' для копирования образов контейнеров Ключ-АСТРОМ из публичных в частные реестры, поскольку '''Docker''' '''CLI''' не обеспечивает простого способа копирования многоархитектурных образов и подписей.

Если вы все еще хотите использовать '''Docker''' '''CLI''', обратитесь к [https://docs.docker.com/reference/cli/docker/ официальной документации Docker CLI].

=== Поддержка классического полнофункционального мониторинга ===
Для классического полнофункционального мониторинга требуется предварительно настроенный образ Ключ-АСТРОМ ЕдиныйАгент, который доступен только через встроенный реестр Ключ-АСТРОМ.

Следовательно, образ ЕдиногоАгента необходимо реплицировать через встроенный реестр Ключ-АСТРОМ, как описано ниже.

==== Прежде чем начать ====
Убедитесь, что вы соответствуете следующим предварительным условиям:

* <code>необходимо</code> Обязательные предварительные условия сверху
* <code>необходимо</code> Учетные данные для встроенного реестра Ключ-АСТРОМ

==== Получите встроенные учетные данные реестра Ключ-АСТРОМ ====
Поскольку встроенный реестр Ключ-АСТРОМ требует аутентификации, вам необходимо знать идентификатор среды мониторинга и предоставить токен '''PaaS''' для входа в систему:

* Чтобы определить <code><your-environment-id></code>, см. [[Мониторинг Среды|идентификатор среды]].
* Чтобы определить <code><your-paas-token></code>, см. [[Токены доступа|токен PaaS]] .

Пример входа с использованием '''''Skopeo'' CLI''':
{| class="wikitable"
|skopeo login -u <your-environment-id> -p <your-paas-token> <your-environment-url>
|}

==== Копирование образа Ключ-АСТРОМ ЕдиныйАгент для классического полнофункционального мониторинга ====
Встроенный реестр Ключ-АСТРОМ поддерживает только архитектуры '''x86-64''' под управлением '''Linux'''. Поэтому мы рекомендуем явно задать/переопределить архитектуру и операционную систему.
{| class="wikitable"
|Как определить тег образа ЕдиныйАгент

Встроенный реестр Ключ-АСТРОМ предоставляет следующие форматы тегов образа ЕдиныйАгент:

* <code>latest</code>
* <code>latest-raw</code>
* <code><major>.<minor>.<revision></code>
* <code><major>.<minor>.<revision>-raw</code>

Для репликации образов мы рекомендуем копировать такие образы (образы с суффиксом тега <code>-raw</code>).
|}

В следующих примерах показано, как версии ЕдиногоАгента преобразуются в теги образов, доступные во встроенном реестре Ключ-АСТРОМ:
{| class="wikitable"
!Версия ЕдиногоАгента
!Тег образа ЕдиногоАгента
|-
|latest
|latest-raw
|-
|1.283.114.20240129-173640
|1.283.114-raw
|}
Перед выполнением следующей команды обязательно замените <code><tag-with-raw-suffix></code> и <code><environment-id></code>:
{| class="wikitable"
|skopeo copy --override-arch amd64 --override-os linux

docker://<your_environment_domain_name>/linux/oneagent:<tag-with-raw-suffix> \

docker://registry.my-company.com/astromkey-oneagent-classic:<tag-with-raw-suffix>
|}

Хранение образов Ключ-АСТРОМ в частных реестрах - История изменений

IKuznetsov: Новая страница: «Для пользователей, желающих получить больший контроль над своей средой хостинга образо...»