Creación de un repositorio

Como todos los paquetes CodeArtifact están almacenados en repositorios, para poder usarlos CodeArtifact, debe crear uno. Puede crear un repositorio mediante la CodeArtifact consola, el AWS Command Line Interface (AWS CLI) o AWS CloudFormation. Cada repositorio está asociado a la AWS cuenta que usaste al crearlo. Puede tener varios repositorios, que se crean y agrupan en dominios. Al crear un repositorio, no contiene ningún paquete. Los repositorios son políglotas, lo que significa que un único repositorio puede contener paquetes de cualquier tipo compatible.

Para obtener información sobre los límites de CodeArtifact servicio, como el número máximo de repositorios permitidos en un solo dominio, consulteCuotas en AWS CodeArtifact. Si alcanza el número máximo de repositorios permitidos, puede eliminar repositorios para dejar espacio para más.

Un repositorio puede tener uno o más CodeArtifact repositorios asociados como repositorios ascendentes. Esto permite a un cliente administrador de paquetes acceder a los paquetes contenidos en más de un repositorio mediante un único punto final. URL Para obtener más información, consulte Trabajar con repositorios ascendentes en CodeArtifact.

Para obtener más información sobre la administración de CodeArtifact repositorios con CloudFormation, consulteCreación de CodeArtifact recursos con AWS CloudFormation.

nota

Después de haber creado un repositorio, no puede cambiar su nombre, cuenta de AWS asociada ni dominio.

Crear un repositorio (consola)

1. Abra la AWS CodeArtifact consola en https://console.aws.amazon.com/codesuite/codeartifact/home.

2. En el panel de navegación, elija Repositorios y luego elija Crear repositorio.

3. En Nombre del repositorio, introduzca un nombre para el repositorio.

4. (Opcional) En Descripción del repositorio, introduzca una descripción opcional para su repositorio.

5. (Opcional) En Publicar repositorios originales, añada repositorios intermedios que conecten sus repositorios con autoridades de paquetes, como Maven Central o npmjs.com.

6. Elija Siguiente.

7. En AWSCuenta, selecciona Esta AWS cuenta si has iniciado sesión en la cuenta propietaria del dominio. Selecciona AWSCuenta diferente si el dominio es propiedad de otra AWS cuenta.

8. En Dominio, elija el dominio en el que se creará el repositorio.

   Si no hay ningún dominio en la cuenta, debe crear uno. Introduzca el nombre del nuevo dominio en Nombre de dominio.

   Expanda Configuración adicional.

   Debes usar una AWS KMS key (KMSclave) para cifrar todos los activos de tu dominio. Puedes usar una Clave administrada de AWS o una KMS clave que administres:

   importante

   CodeArtifact solo admite KMSclaves simétricas. No puede utilizar una KMSclave asimétrica para cifrar sus dominios. CodeArtifact Para obtener ayuda para determinar si una KMS clave es simétrica o asimétrica, consulta Cómo identificar claves simétricas y asimétricas. KMS

   • Elija la clave AWS administrada si quiere usar la predeterminada. Clave administrada de AWS

   • Elija la clave administrada por el cliente si desea usar una KMS clave que usted administre. Para usar una KMS clave que usted administre, en Clave administrada por el cliente ARN, busque y elija la KMS clave.

   Para obtener más información, consulte Claves administradas por AWS y las claves administradas por el cliente en la Guía para desarrolladores de AWS Key Management Service .

9. Elija Siguiente.

10. En Revisar y crear, revisa lo que CodeArtifact está creando por ti.

    • Flujo de paquetes muestra cómo están conectados su dominio y sus repositorios.

    • Paso 1: Crear un repositorio muestra los detalles sobre el repositorio y los repositorios ascendentes opcionales que se van a crear.

    • Paso 2: Seleccionar el dominio, se muestran los detalles sobre my_domain.

    Cuando haya terminado, elija Crear repositorio.

Creación de un repositorio (AWS CLI)

Use el comando create-repository para crear un repositorio en su dominio.

aws codeartifact create-repository --domain my_domain --domain-owner 111122223333 --repository my_repo --description "My new repository"

Ejemplo de salida:

{
    "repository": {
        "name": "my_repo",
        "administratorAccount": "123456789012",
        "domainName": "my_domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:region-id:111122223333:repository/my_domain/my_repo",
        "description": "My new repository",
        "upstreams": "[]",
        "externalConnections"" "[]"
    }
}

Un repositorio nuevo no contiene ningún paquete. Cada repositorio está asociado a la cuenta de AWS en la que se autenticó cuando se creó el repositorio.

Crear un repositorio con etiquetas

Para crear un repositorio con etiquetas, añada el parámetro --tags a su comando create-domain.

aws codeartifact create-repository --domain my_domain --domain-owner 111122223333 --repository my_repo --tags key=k1,value=v1 key=k2,value=v2

Crear un repositorio con un repositorio ascendente

Puede especificar uno o más repositorios ascendentes al crear un repositorio.

aws codeartifact create-repository --domain my_domain --domain-owner 111122223333 --repository my_repo \
  --upstreams repositoryName=my-upstream-repo --repository-description "My new repository"

Ejemplo de salida:

{
    "repository": {
        "name": "my_repo",
        "administratorAccount": "123456789012",
        "domainName": "my_domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:region-id:111122223333:repository/my_domain/my_repo",
        "description": "My new repository",
        "upstreams": [
            {
                "repositoryName": "my-upstream-repo"
            }
        ],
        "externalConnections"" "[]"
    }
}

nota

Para crear un repositorio con un repositorio ascendente, debe tener permiso para realizar la acción AssociateWithDownstreamRepository en el repositorio ascendente.

Para añadir un archivo ascendente a un repositorio una vez creado, consulte Añadir o eliminar repositorios ascendentes (consola) y Añadir o eliminar repositorios ascendentes (AWS CLI).