ProHoster > Blog > administración > Instalación y configuración de Nexus Sonatype utilizando la infraestructura como enfoque de código
Instalación y configuración de Nexus Sonatype utilizando la infraestructura como enfoque de código
Sonatype Nexus es una plataforma integrada a través de la cual los desarrolladores pueden representar, almacenar y administrar dependencias de Java (Maven), Docker, Python, Ruby, NPM, imágenes de Bower, paquetes RPM, gitlfs, Apt, Go, Nuget y distribuir su software de seguridad.
¿Por qué necesitas Sonatype Nexus?
Para almacenar artefactos privados;
Para almacenar en caché artefactos que se descargan de Internet;
Artefactos admitidos en el paquete básico de Sonatype Nexus:
Variables con valores predeterminados (ver default/main.yml):
Variables generales
nexus_version: ''
nexus_timezone: 'UTC'
De forma predeterminada, la función instalará la última versión disponible de Nexus. Puedes arreglar la versión cambiando la variable. nexus_version. Ver versiones disponibles en https://www.sonatype.com/download-oss-sonatype.
Si cambia a una versión más nueva, la función intentará actualizar su instalación de Nexus.
Si está utilizando una versión de Nexus anterior a la última, debe asegurarse de no utilizar funciones que no estén disponibles en la versión instalada (por ejemplo, alojar repositorios yum está disponible para nexus superiores a 3.8.0, repositorio git lfs para nexos superiores a 3.3.0, etc.)
nexus timezone es el nombre de la zona horaria de Java, que puede resultar útil en combinación con las siguientes expresiones cron para tareas nexus_scheduled.
El puerto y la ruta de contexto del proceso de conexión de Java. nexus_default_context_path debe contener una barra diagonal cuando se establece, por ejemplo: nexus_default_context_path: '/nexus/'.
Usuario y grupo de Nexus OS
nexus_os_group: 'nexus'
nexus_os_user: 'nexus'
El usuario y el grupo utilizados para poseer los archivos Nexus y ejecutar el servicio serán creados por la función si falta uno.
nexus_os_user_home_dir: '/home/nexus'
Permitir cambiar el directorio de inicio predeterminado para el usuario Nexus
nexus_data_dir contiene toda la configuración, repositorios y artefactos descargados. Rutas de acceso personalizadas del almacén de blobs nexus_data_dir Se puede personalizar, ver más abajo nexus_blobstores.
nexus_tmp_dir contiene todos los archivos temporales. La ruta predeterminada para redhat se ha movido de /tmp para superar problemas potenciales con los procedimientos de limpieza automática. Ver #168.
Como segunda advertencia, aquí hay un extracto del documento anterior:
No se recomienda aumentar la memoria dinámica de JVM más allá de los valores recomendados en un intento de mejorar el rendimiento. En realidad, esto puede tener el efecto contrario, lo que resultará en un trabajo innecesario para el sistema operativo.
Contraseña de administrador
nexus_admin_password: 'changeme'
La contraseña de la cuenta "admin" para la configuración. Esto sólo funciona en la primera instalación predeterminada.. Consulte [Cambiar la contraseña de administrador después de la primera instalación] (# cambiar-contraseña-admin-después-de-la-primera-instalación) si desea cambiarla más adelante usando una función.
Se recomienda encarecidamente no almacenar su contraseña en texto claro en el libro de jugadas, sino utilizar [cifrado de bóveda ansible] (https://docs.ansible.com/ansible/latest/user_guide/vault.html) (ya sea en línea o en un archivo separado cargado con, por ejemplo, include_vars)
Acceso anónimo por defecto
nexus_anonymous_access: false
El acceso anónimo está deshabilitado de forma predeterminada. Leer más sobre acceso anónimo.
Estas variables controlan cómo el rol se conecta a la API de Nexus para el aprovisionamiento. Sólo para usuarios avanzados. Probablemente no quieras cambiar estas configuraciones predeterminadas
Establecer Proxy inverso SSL.
Para hacer esto necesitas instalar httpd. Nota: cuando para httpd_setup_enable valor ajustadotrue, contactos de nexo 127.0.0.1:8081, por lo tanto no siendo accesible directamente a través del puerto HTTP 8081 desde la dirección IP externa.
El nombre de host predeterminado utilizado es nexus_public_hostname. Si necesita nombres diferentes por algún motivo, puede configurar httpd_server_name con un significado diferente.
С httpd_copy_ssl_files: true (De forma predeterminada), los certificados anteriores deben existir en el directorio de su libro de jugadas y se copiarán al servidor y se configurarán en Apache.
Si desea utilizar certificados existentes en el servidor, instale httpd_copy_ssl_files: false y proporcione las siguientes variables:
# These specifies to the vhost where to find on the remote server file
# system the certificate files.
httpd_ssl_cert_file_location: "/etc/pki/tls/certs/wildcard.vm.crt"
httpd_ssl_cert_key_location: "/etc/pki/tls/private/wildcard.vm.key"
# httpd_ssl_cert_chain_file_location: "{{ httpd_ssl_cert_file_location }}"
httpd_ssl_cert_chain_file_location es opcional y debe dejarse sin configurar si no desea personalizar el archivo de cadena
nexus_privileges:
- name: all-repos-read # used as key to update a privilege
# type: <one of application, repository-admin, repository-content-selector, repository-view, script or wildcard>
description: 'Read & Browse access to all repos'
repository: '*'
actions: # can be add, browse, create, delete, edit, read or * (all)
- read
- browse
# pattern: pattern
# domain: domain
# script_name: name
Lista privilegios para la configuración. Mire la documentación y la GUI para verificar qué variables deben configurarse según el tipo de privilegio.
Estos elementos se combinan con los siguientes valores predeterminados:
nexus_roles:
- id: Developpers # can map to a LDAP group id, also used as a key to update a role
name: developers
description: All developers
privileges:
- nx-search-read
- all-repos-read
roles: [] # references to other role names
nexus_local_users: []
# - username: jenkins # used as key to update
# state: present # default value if ommited, use 'absent' to remove user
# first_name: Jenkins
# last_name: CI
# email: [email protected]
# password: "s3cr3t"
# roles:
# - developers # role ID
Lista de cuentas/usuarios locales (no LDAP) para crear en Nexus.
Lista de usuarios/cuentas locales (no LDAP) para crear en Nexus.
Mapeo Ldap de usuarios/roles. Estado absent eliminará roles de un usuario existente si ya existe uno.
Los usuarios de Ldap no se eliminan. Intentar establecer una función para un usuario inexistente generará un error.
Selectores de contenido
nexus_content_selectors:
- name: docker-login
description: Selector for docker login privilege
search_expression: format=="docker" and path=~"/v2/"
Para obtener más información sobre el selector de contenido, consulte Documentación.
Para usar el selector de contenido, agregue un nuevo privilegio con type: repository-content-selector y relevantecontentSelector
Elimine los repositorios de la configuración predeterminada inicial de instalación de Nexus. Este paso sólo se ejecuta en la instalación por primera vez (cuando nexus_data_dir se ha detectado vacío).
Eliminando repositorios de la configuración predeterminada predeterminada para Nexus. Este paso sólo se realiza durante la primera instalación (cuando nexus_data_dir vacío).
nexus_delete_default_blobstore: false
Elimine el almacén de blob predeterminado de la configuración predeterminada inicial de instalación de Nexus. Esto se puede hacer sólo si nexus_delete_default_repos: true y todos los repositorios configurados (ver más abajo) tienen un explícito blob_store: custom. Este paso sólo se ejecuta en la instalación por primera vez (cuando nexus_data_dir se ha detectado vacío).
La eliminación del almacenamiento de blobs (artefactos binarios) está deshabilitada de forma predeterminada desde la configuración inicial. Para eliminar el almacenamiento de blobs (artefactos binarios), desactive nexus_delete_default_repos: true. Este paso sólo se realiza durante la primera instalación (cuando nexus_data_dir vacío).
Tiendas de blobs crear. Una ruta de acceso al almacén de blobs y un almacén de blobs de repositorio no se pueden actualizar después de la creación inicial (cualquier actualización aquí se ignorará al volver a aprovisionarse).
La configuración de blobstore en S3 se proporciona para su comodidad y no forma parte de las pruebas automatizadas que ejecutamos en travis. Tenga en cuenta que el almacenamiento en S3 solo se recomienda para instancias implementadas en AWS.
Creación Tiendas de blobs. La ruta de almacenamiento y el repositorio de almacenamiento no se pueden actualizar después de la creación inicial (cualquier actualización aquí se ignorará cuando se instale nuevamente).
La configuración del almacenamiento de blobs en S3 se proporciona para su comodidad. Tenga en cuenta que el almacenamiento S3 solo se recomienda para instancias implementadas en AWS.
Arriba hay una configuración de ejemplo. servidor proxy Experto.
nexus_repos_maven_hosted:
- name: private-release
version_policy: release
write_policy: allow_once # one of "allow", "allow_once" or "deny"
Maven repositorios alojados configuración. La configuración de caché negativa es opcional y, de forma predeterminada, utilizará los valores anteriores si se omite.
Configuración repositorios alojados Maven. La configuración de caché negativa (-1) es opcional y, de forma predeterminada, utilizará los valores anteriores si no se especifica.
nexus_repos_maven_group:
- name: public
member_repos:
- central
- jboss
Los tres tipos de repositorio se combinan con los siguientes valores predeterminados:
_nexus_repos_maven_defaults:
blob_store: default # Note : cannot be updated once the repo has been created
strict_content_validation: true
version_policy: release # release, snapshot or mixed
layout_policy: strict # strict or permissive
write_policy: allow_once # one of "allow", "allow_once" or "deny"
maximum_component_age: -1 # Nexus gui default. For proxies only
maximum_metadata_age: 1440 # Nexus gui default. For proxies only
negative_cache_enabled: true # Nexus gui default. For proxies only
negative_cache_ttl: 1440 # Nexus gui default. For proxies only
Tipos de repositorio Docker, Pypi, Raw, Rubygems, Bower, NPM, Git-LFS y yum:
ver defaults/main.yml para estas opciones:
Los repositorios Docker, Pypi, Raw, Rubygems, Bower, NPM, Git-LFS y yum están deshabilitados de forma predeterminada:
ver defaults/main.yml para estas opciones:
Tenga en cuenta que es posible que deba habilitar ciertos alcances de seguridad si desea utilizar otros tipos de repositorios distintos de maven. Esto es falso por defecto.
El dominio de usuario remoto también se puede habilitar usando
nexus_rut_auth_realm: true
y el título se puede personalizar definiendo
nexus_rut_auth_header: "CUSTOM_HEADER"
Tareas programadas
nexus_scheduled_tasks: []
# # Example task to compact blobstore :
# - name: compact-docker-blobstore
# cron: '0 0 22 * * ?'
# typeId: blobstore.compact
# task_alert_email: [email protected] # optional
# taskProperties:
# blobstoreName: {{ nexus_blob_names.docker.blob }} # all task attributes are stored as strings by nexus internally
# # Example task to purge maven snapshots
# - name: Purge-maven-snapshots
# cron: '0 50 23 * * ?'
# typeId: repository.maven.remove-snapshots
# task_alert_email: [email protected] # optional
# taskProperties:
# repositoryName: "*" # * for all repos. Change to a repository name if you only want a specific one
# minimumRetained: "2"
# snapshotRetentionDays: "2"
# gracePeriodInDays: "2"
# booleanTaskProperties:
# removeIfReleased: true
# # Example task to purge unused docker manifest and images
# - name: Purge unused docker manifests and images
# cron: '0 55 23 * * ?'
# typeId: "repository.docker.gc"
# task_alert_email: [email protected] # optional
# taskProperties:
# repositoryName: "*" # * for all repos. Change to a repository name if you only want a specific one
# # Example task to purge incomplete docker uploads
# - name: Purge incomplete docker uploads
# cron: '0 0 0 * * ?'
# typeId: "repository.docker.upload-purge"
# task_alert_email: [email protected] # optional
# taskProperties:
# age: "24"
Tareas programadas para la configuración. typeId y tarea específicataskProperties/booleanTaskProperties puedes adivinar:
de la jerarquía de tipos de Java org.sonatype.nexus.scheduling.TaskDescriptorSupport
comprobar el formulario de creación de tareas HTML en su navegador
de ver solicitudes AJAX en el navegador al configurar manualmente una tarea.
Las propiedades de las tareas deben declararse en el bloque yaml correcto según su tipo.:
taskProperties para todas las propiedades de cadena (es decir, nombres de repositorios, nombres de repositorios, períodos de tiempo...).
booleanTaskProperties para todas las propiedades lógicas (es decir, principalmente casillas de verificación en la GUI de la tarea de creación del nexo).
La copia de seguridad no se configurará hasta que cambie nexus_backup_configure в true.
En este caso, la tarea de script programada se configurará para ejecutarse en Nexus
en el intervalo especificado en nexus_backup_cron (por defecto 21:00 todos los días).
Consulte [plantilla maravillosa para esta tarea](templates/backup.groovy.j2) para obtener más detalles.
Esta tarea programada es independiente de otras. nexus_scheduled_taskscual tu
anuncie en su libro de jugadas.
Si desea rotar/eliminar copias de seguridad, instale nexus_backup_rotate: true y configure la cantidad de copias de seguridad que desea guardar usando nexus_backup_keep_rotations (predeterminado 4).
Al utilizar la rotación, si desea ahorrar espacio adicional en el disco durante el proceso de copia de seguridad,
Puedes instalar nexus_backup_rotate_first: true. Esto configurará la rotación/eliminación previa antes de la copia de seguridad. De forma predeterminada, la rotación se produce después de crear una copia de seguridad. Tenga en cuenta que en este caso las copias de seguridad antiguas
se eliminará antes de realizar la copia de seguridad actual.
Procedimiento de recuperación
Ejecutar libro de jugadas con parámetro -e nexus_restore_point=<YYYY-MM-dd-HH-mm-ss>
(por ejemplo, 2017-12-17-21-00-00 para el 17 de diciembre de 2017 a las 21:00
Eliminando nexo
Advertencia: Esto eliminará completamente sus datos actuales. Asegúrese de hacer una copia de seguridad antes si es necesario
Usa una variable nexus_purgesi necesita reiniciar desde cero y reinstalar la instancia de Nexus con todos los datos eliminados.
Cambiar la contraseña de administrador después de la primera instalación
nexus_default_admin_password: 'admin123'
Esto no debe cambiarse en su libro de jugadas.. Esta variable se completa con la contraseña de administrador predeterminada de Nexus cuando se instala por primera vez y garantiza que podamos cambiar la contraseña de administrador a nexus_admin_password.
Si desea cambiar la contraseña de administrador después de la primera instalación, puede cambiarla temporalmente a la contraseña anterior desde la línea de comando. Después del cambio nexus_admin_password en tu libro de jugadas puedes ejecutar: