codeartifact

Описание

CodeArtifact — это полностью управляемый репозиторий артефактов, совместимый с пакетными менеджерами и средствами сборки, нативным для языка, такими как npm, Apache Maven, pip и dotnet. Вы можете использовать CodeArtifact для совместного использования пакетов с командами разработчиков и извлечения пакетов. Пакеты могут быть извлечены из публичных и репозиториев CodeArtifact. Вы также можете создать взаимосвязь «upstream» между репозиторием CodeArtifact и другим репозиторием, что эффективно объединяет их содержимое с точки зрения клиента пакетного менеджера.

• Репозиторий : Репозиторий CodeArtifact содержит набор версий пакетов, каждая из которых сопоставляется с набором ресурсов или файлов. Репозитории являются полиглотными, поэтому один репозиторий может содержать пакеты любого поддерживаемого типа. Каждый репозиторий предоставляет конечные точки для извлечения и публикации пакетов с использованием таких инструментов, как ** npm ** CLI или Maven CLI (** mvn **). Список поддерживаемых пакетных менеджеров см. в руководстве пользователя CodeArtifact.
• Домен : Репозитории агрегируются в сущность более высокого уровня, известную как домен. Все ресурсы пакетов и метаданные хранятся в домене, но потребляются через репозитории. Определённый ресурс пакета, например, файл Maven JAR, хранится один раз на домен, независимо от того, сколько раз он присутствует в репозиториях. Все ресурсы и метаданные в домене шифруются с использованием одного и того же главного ключа шифрования клиента (CMK), хранящегося в службе управления ключами (KMS). Каждый репозиторий является членом одного домена и не может быть перемещён в другой домен. Домен позволяет применять политику организации ко многим репозиториям, например, какие учётные записи могут получать доступ к репозиториям в домене, и какие публичные репозитории могут использоваться в качестве источников пакетов. Хотя организация может иметь несколько доменов, рекомендуется использовать один производственный домен, содержащий все опубликованные артефакты, чтобы команды могли находить и совместно использовать пакеты по всей организации.
• Пакет : Пакет — это набор программного обеспечения и метаданных, необходимых для разрешения зависимостей и установки программного обеспечения. CodeArtifact поддерживает npm, PyPI, Maven, NuGet, Swift, Ruby, Cargo и общие форматы пакетов. Дополнительную информацию о поддерживаемых форматах пакетов и о том, как использовать CodeArtifact с ними, см. в руководстве пользователя CodeArtifact. В CodeArtifact пакет состоит из:
  • Имени (например, webpack — имя популярного пакета npm)
  • Необязательного пространства имён (например, @types в @types/node )
  • Набора версий (например, 1.0.0, 1.0.1, 1.0.2 и т. д.)
  • Метаданных пакета (например, теги npm)
• Группа пакетов : Группа пакетов, которые соответствуют заданному определению. Группы пакетов могут использоваться для применения конфигурации к нескольким пакетам, которые соответствуют заданному шаблону с использованием формата пакета, пространства имён пакета и имени пакета. Вы можете использовать группы пакетов для более удобной настройки управления происхождением пакетов для нескольких пакетов. Управление происхождением пакетов используется для блокирования или разрешения загрузки или публикации новых версий пакетов, что защищает пользователей от вредоносных действий, известных как атаки подмены зависимостей.
• Версия пакета : Версия пакета, например, @types/node 12.6.9. Формат и семантика номера версии различаются для различных форматов пакетов. Например, версии пакетов npm должны соответствовать спецификации Semantic Versioning.
• Upstream-репозиторий : Один репозиторий является upstream для другого, когда к версиям пакетов в нём можно получить доступ из конечной точки репозитория downstream, что эффективно объединяет содержимое двух репозиториев с точки зрения клиента. CodeArtifact позволяет создавать взаимосвязь «upstream» между двумя репозиториями.
• Ресурс : Отдельный файл, хранящийся в CodeArtifact, связанный с версией пакета, например, файл npm .tgz или файлы Maven POM и JAR.

• AssociateExternalConnection : Добавляет существующее внешнее подключение к репозиторию.
• CopyPackageVersions : Копирует версии пакетов из одного репозитория в другой репозиторий в том же домене.
• CreateDomain : Создаёт домен.
• CreatePackageGroup : Создаёт группу пакетов.
• CreateRepository : Создаёт репозиторий CodeArtifact в домене.
• DeleteDomain : Удаляет домен. Вы не можете удалить домен, содержащий репозитории.
• DeleteDomainPermissionsPolicy : Удаляет политику ресурса, установленную на домене.
• DeletePackage : Удаляет пакет и все связанные с ним версии пакетов.
• DeletePackageGroup : Удаляет группу пакетов. Не удаляет пакеты или версии пакетов, связанные с группой пакетов.
• DeletePackageVersions : Удаляет версии пакета. После удаления пакета его можно повторно опубликовать, но его ресурсы и метаданные восстановить нельзя, поскольку они были окончательно удалены из хранилища.
• DeleteRepository : Удаляет репозиторий.
• DeleteRepositoryPermissionsPolicy : Удаляет политику ресурса, установленную на репозитории.
• DescribeDomain : Возвращает объект DomainDescription, содержащий информацию о запрошенном домене.
• DescribePackage : Возвращает объект PackageDescription, содержащий подробности о пакете.
• DescribePackageGroup : Возвращает объект PackageGroup, содержащий подробности о группе пакетов.
• DescribePackageVersion : Возвращает объект PackageVersionDescription, содержащий подробности о версии пакета.
• DescribeRepository : Возвращает объект RepositoryDescription, содержащий подробную информацию о запрошенном репозитории.
• DisposePackageVersions : Удаляет версии пакета. Версия пакета со статусом Disposed не может быть восстановлена, поскольку они были окончательно удалены из хранилища.
• DisassociateExternalConnection : Удаляет существующее внешнее подключение из репозитория.
• GetAssociatedPackageGroup : Возвращает наиболее связанную группу пакетов со специфицированным пакетом.
• GetAuthorizationToken : Генерирует временный токен авторизации для доступа к репозиториям в домене. Токен истекает после окончания срока авторизации. По умолчанию срок авторизации составляет 12 часов и может быть настроен на любой срок, не превышающий 12 часов.
• GetDomainPermissionsPolicy : Возвращает политику ресурса, прикреплённого к указанному домену.
• GetPackageVersionAsset : Возвращает содержимое ресурса, находящегося в версии пакета.
• GetPackageVersionReadme : Получает файл README или описательный текст для версии пакета.
• GetRepositoryEndpoint : Возвращает конечную точку репозитория для определённого формата пакета. У репозитория есть одна конечная точка для каждого формата пакета:
  • cargo
  • generic
  • maven
  • npm
  • nuget
  • pypi
  • ruby
  • swift
• GetRepositoryPermissionsPolicy : Возвращает политику ресурса, установленную на репозитории.
• ListAllowedRepositoriesForGroup : Выводит список разрешённых репозиториев для группы пакетов, у которой конфигурация происхождения установлена на ALLOW_SPECIFIC_REPOSITORIES.
• ListAssociatedPackages : Возвращает список пакетов, связанных с запрошенной группой пакетов.
• ListDomains : Возвращает список объектов DomainSummary. Каждый возвращённый объект DomainSummary содержит информацию о домене.
• ListPackages : Выводит список пакетов в репозитории.
• ListPackageGroups : Возвращает список групп пакетов в запрошенном домене.
• ListPackageVersionAssets : Возвращает список ресурсов для заданной версии пакета.
• ListPackageVersionDependencies : Возвращает список прямых зависимостей для версии пакета.
• ListPackageVersions : Возвращает список версий пакетов для указанного пакета в репозитории.
• ListRepositories : Возвращает список репозиториев, принадлежащих учётной записи Amazon Web Services, которая вызвала этот метод.
• ListRepositoriesInDomain : Возвращает список репозиториев в домене.
• ListSubPackageGroups : Возвращает список прямых дочерних элементов указанной группы пакетов.
• PublishPackageVersion : Создаёт новую версию пакета, содержащую один или несколько ресурсов.
• PutDomainPermissionsPolicy : Присоединяет политику ресурса к домену.
• PutPackageOriginConfiguration : Устанавливает конфигурацию происхождения пакета для пакета, которая определяет, как можно добавлять новые версии пакета в определённый репозиторий.
• PutRepositoryPermissionsPolicy : Устанавливает политику ресурса для репозитория, определяющую разрешения на доступ к нему.
• UpdatePackageGroup : Обновляет группу пакетов. Этот API нельзя использовать для обновления конфигурации происхождения или шаблона группы пакетов.
• UpdatePackageGroupOriginConfiguration : Обновляет конфигурацию происхождения пакета для группы пакетов.
• UpdatePackageVersionsStatus : Обновляет статус одной или нескольких версий пакета.
• UpdateRepository : Обновляет свойства репозитория.

Доступные команды