🥇Nexus Sonatype instalēšana un konfigurēšana, izmantojot infrastruktūru kā kodu pieeju

Sonatype Nexus ir integrēta platforma, ar kuras palīdzību izstrādātāji var izmantot starpniekserveri, uzglabāt un pārvaldīt Java (Maven) atkarības, Docker, Python, Ruby, NPM, Bower attēlus, RPM pakotnes, gitlfs, Apt, Go, Nuget un izplatīt savu programmatūras drošību.

Kāpēc jums ir nepieciešams Sonatype Nexus?

Privātu artefaktu glabāšanai;
No interneta lejupielādētu artefaktu saglabāšanai kešatmiņā;

Artefakti, kas tiek atbalstīti pamata Sonatype Nexus pakotnē:

Java, Maven (burka)
dokers
Python (pip)
Rubīns (dārgakmens)
NPM
lapene
Yum (apgr./min)
gitlfs
Neapstrādāts
Apt (deb)
Go
Nuget

Kopienas atbalstītie artefakti:

Komponists
Conan
CPAN
ELPA
Stūre
P2
R

Sonatype Nexus instalēšana, izmantojot https://github.com/ansible-ThoTeam/nexus3-oss

Prasības

Lasiet par ansible lietošanu internetā.
Uzstādiet iespējams pip install ansible darbstacijā, kurā darbojas rokasgrāmata.
Komplekts geerlingguy.java darbstacijā, kurā darbojas rokasgrāmata.
Komplekts geerlingguy.apache darbstacijā, kurā darbojas rokasgrāmata.
Šī loma ir pārbaudīta operētājsistēmās CentOS 7, Ubuntu Xenial (16.04) un Bionic (18.04), Debian Jessie un Stretch
jmespath Bibliotēka ir jāinstalē darbstacijā, kurā darbojas rokasgrāmata. Lai instalētu: sudo pip install -r requirements.txt
Saglabājiet rokasgrāmatas failu (piemērs tālāk) failā nexus.yml
Palaidiet nexus instalēšanu ansible-playbook -i host nexus.yml

Iespējamās rokasgrāmatas piemērs nexus instalēšanai bez LDAP ar Maven (java), Docker, Python, Ruby, NPM, Bower, RPM un gitlfs krātuvēm.

---
- name: Nexus
  hosts: nexus
  become: yes

  vars:
    nexus_timezone: 'Asia/Omsk'
    nexus_admin_password: "admin123"
    nexus_public_hostname: 'apatsev-nexus-playbook'
    httpd_setup_enable: false
    nexus_privileges:
      - name: all-repos-read
        description: 'Read & Browse access to all repos'
        repository: '*'
        actions:
          - read
          - browse
      - name: company-project-deploy
        description: 'Deployments to company-project'
        repository: company-project
        actions:
          - add
          - edit
    nexus_roles:
      - id: Developpers # maps to the LDAP group
        name: developers
        description: All developers
        privileges:
          - nx-search-read
          - all-repos-read
          - company-project-deploy
        roles: []
    nexus_local_users:
      - username: jenkins # used as key to update
        first_name: Jenkins
        last_name: CI
        email: [email protected]
        password: "s3cr3t"
        roles:
          - Developpers # role ID here
    nexus_blobstores:
      - name: company-artifacts
        path: /var/nexus/blobs/company-artifacts
    nexus_scheduled_tasks:
      - name: compact-blobstore
        cron: '0 0 22 * * ?'
        typeId: blobstore.compact
        taskProperties:
          blobstoreName: 'company-artifacts'

    nexus_repos_maven_proxy:
      - name: central
        remote_url: 'https://repo1.maven.org/maven2/'
        layout_policy: permissive
      - name: jboss
        remote_url: 'https://repository.jboss.org/nexus/content/groups/public-jboss/'
      - name: vaadin-addons
        remote_url: 'https://maven.vaadin.com/vaadin-addons/'
      - name: jaspersoft
        remote_url: 'https://jaspersoft.artifactoryonline.com/jaspersoft/jaspersoft-repo/'
        version_policy: mixed
    nexus_repos_maven_hosted:
      - name: company-project
        version_policy: mixed
        write_policy: allow
        blob_store: company-artifacts
    nexus_repos_maven_group:
      - name: public
        member_repos:
          - central
          - jboss
          - vaadin-addons
          - jaspersoft

    # Yum. Change nexus_config_yum to true for create yum repository
    nexus_config_yum: true
    nexus_repos_yum_hosted:
      - name: private_yum_centos_7
        repodata_depth: 1
    nexus_repos_yum_proxy:
      - name: epel_centos_7_x86_64
        remote_url: http://download.fedoraproject.org/pub/epel/7/x86_64
        maximum_component_age: -1
        maximum_metadata_age: -1
        negative_cache_ttl: 60
      - name: centos-7-os-x86_64
        remote_url: http://mirror.centos.org/centos/7/os/x86_64/
        maximum_component_age: -1
        maximum_metadata_age: -1
        negative_cache_ttl: 60
    nexus_repos_yum_group:
      - name: yum_all
        member_repos:
          - private_yum_centos_7
          - epel_centos_7_x86_64

    # NPM. Change nexus_config_npm to true for create npm repository
    nexus_config_npm: true
    nexus_repos_npm_hosted: []
    nexus_repos_npm_group:
      - name: npm-public
        member_repos:
          - npm-registry
    nexus_repos_npm_proxy:
      - name: npm-registry
        remote_url: https://registry.npmjs.org/
        negative_cache_enabled: false

    # Docker. Change nexus_config_docker to true for create docker repository
    nexus_config_docker: true
    nexus_repos_docker_hosted:
      - name: docker-hosted
        http_port: "{{ nexus_docker_hosted_port }}"
        v1_enabled: True
    nexus_repos_docker_proxy:
      - name: docker-proxy
        http_port: "{{ nexus_docker_proxy_port }}"
        v1_enabled: True
        index_type: "HUB"
        remote_url: "https://registry-1.docker.io"
        use_nexus_certificates_to_access_index: false
        maximum_component_age: 1440
        maximum_metadata_age: 1440
        negative_cache_enabled: true
        negative_cache_ttl: 1440
    nexus_repos_docker_group:
      - name: docker-group
        http_port: "{{ nexus_docker_group_port }}"
        v1_enabled: True
        member_repos:
          - docker-hosted
          - docker-proxy

    # Bower. Change nexus_config_bower to true for create bower repository
    nexus_config_bower: true
    nexus_repos_bower_hosted:
      - name: bower-hosted
    nexus_repos_bower_proxy:
      - name: bower-proxy
        index_type: "proxy"
        remote_url: "https://registry.bower.io"
        use_nexus_certificates_to_access_index: false
        maximum_component_age: 1440
        maximum_metadata_age: 1440
        negative_cache_enabled: true
        negative_cache_ttl: 1440
    nexus_repos_bower_group:
      - name: bower-group
        member_repos:
          - bower-hosted
          - bower-proxy

    # Pypi. Change nexus_config_pypi to true for create pypi repository
    nexus_config_pypi: true
    nexus_repos_pypi_hosted:
      - name: pypi-hosted
    nexus_repos_pypi_proxy:
      - name: pypi-proxy
        index_type: "proxy"
        remote_url: "https://pypi.org/"
        use_nexus_certificates_to_access_index: false
        maximum_component_age: 1440
        maximum_metadata_age: 1440
        negative_cache_enabled: true
        negative_cache_ttl: 1440
    nexus_repos_pypi_group:
      - name: pypi-group
        member_repos:
          - pypi-hosted
          - pypi-proxy

    # rubygems. Change nexus_config_rubygems to true for create rubygems repository
    nexus_config_rubygems: true
    nexus_repos_rubygems_hosted:
      - name: rubygems-hosted
    nexus_repos_rubygems_proxy:
      - name: rubygems-proxy
        index_type: "proxy"
        remote_url: "https://rubygems.org"
        use_nexus_certificates_to_access_index: false
        maximum_component_age: 1440
        maximum_metadata_age: 1440
        negative_cache_enabled: true
        negative_cache_ttl: 1440
    nexus_repos_rubygems_group:
      - name: rubygems-group
        member_repos:
          - rubygems-hosted
          - rubygems-proxy

    # gitlfs. Change nexus_config_gitlfs to true for create gitlfs repository
    nexus_config_gitlfs: true
    nexus_repos_gitlfs_hosted:
      - name: gitlfs-hosted

  roles:
    - { role: geerlingguy.java }
    # Debian/Ubuntu only
    # - { role: geerlingguy.apache, apache_create_vhosts: no, apache_mods_enabled: ["proxy_http.load", "headers.load"], apache_remove_default_vhost: true, tags: ["geerlingguy.apache"] }
    # RedHat/CentOS only
    - { role: geerlingguy.apache, apache_create_vhosts: no, apache_remove_default_vhost: true, tags: ["geerlingguy.apache"] }
    - { role: ansible-thoteam.nexus3-oss, tags: ['ansible-thoteam.nexus3-oss'] }

Ekrānuzņēmumi:

Mainīgas lomas

Lomu mainīgie

Mainīgie ar noklusējuma vērtībām (sk default/main.yml):

Vispārīgi mainīgie

    nexus_version: ''
    nexus_timezone: 'UTC'

Pēc noklusējuma loma instalēs jaunāko pieejamo Nexus versiju. Varat labot versiju, mainot mainīgo nexus_version. Pieejamās versijas skatiet vietnē https://www.sonatype.com/download-oss-sonatype.

Ja mainīsit uz jaunāku versiju, loma mēģinās atjaunināt jūsu Nexus instalāciju.

Ja izmantojat vecāku Nexus versiju par jaunāko, pārliecinieties, ka neizmantojat funkcijas, kas nav pieejamas instalētajā laidienā (piemēram, yum repozitoriju mitināšana ir pieejama nexus versijai, kas ir lielāka par 3.8.0, git lfs repo nexus, kas ir lielāks par 3.3.0 utt.)

nexus timezone ir Java laika joslas nosaukums, kas var būt noderīgs kopā ar tālāk norādītajām cron izteiksmēm nexus_scheduled uzdevumiem.

Nexus ports un konteksta ceļš

    nexus_default_port: 8081
    nexus_default_context_path: '/'

Java savienojuma procesa ports un konteksta ceļš. nexus_default_context_path ir jāietver slīpsvītra, kad tā ir iestatīta, piemēram: nexus_default_context_path: '/nexus/'.

Nexus OS lietotājs un grupa

    nexus_os_group: 'nexus'
    nexus_os_user: 'nexus'

Lietotājs un grupa, kas izmantoja Nexus failu īpašumtiesības un pakalpojuma palaišanu, tiks izveidota pēc lomas, ja tādas trūkst.

    nexus_os_user_home_dir: '/home/nexus'

Atļaut mainīt noklusējuma mājas direktoriju nexus lietotājam

Nexus gadījumu direktoriji

    nexus_installation_dir: '/opt'
    nexus_data_dir: '/var/nexus'
    nexus_tmp_dir: "{{ (ansible_os_family == 'RedHat') | ternary('/var/nexus-tmp', '/tmp/nexus') }}"

Nexus katalogi.

nexus_installation_dir satur instalētos izpildāmos failus
nexus_data_dir satur visas konfigurācijas, krātuves un lejupielādētos artefaktus. Pielāgoti blobstore ceļi nexus_data_dir var pielāgot, skatiet tālāk nexus_blobstores.
nexus_tmp_dir satur visus pagaidu failus. Redhat noklusējuma ceļš ir pārvietots no /tmp lai pārvarētu iespējamās problēmas ar automātiskajām tīrīšanas procedūrām. Skatiet #168.

Nexus JVM atmiņas lietojuma konfigurēšana

    nexus_min_heap_size: "1200M"
    nexus_max_heap_size: "{{ nexus_min_heap_size }}"
    nexus_max_direct_memory: "2G"

Šie ir Nexus noklusējuma iestatījumi. Lūdzu, nemainiet šīs vērtības Ja neesi lasījis nexus sistēmas prasību atmiņas sadaļa un nesaprot, ko viņi dara.

Kā otru brīdinājumu šeit ir izvilkums no iepriekš minētā dokumenta:

Lai uzlabotu veiktspēju, nav ieteicams palielināt JVM kaudzes atmiņu, pārsniedzot ieteiktās vērtības. Tam faktiski var būt pretējs efekts, radot operētājsistēmai nevajadzīgu darbu.

Administratora parole

    nexus_admin_password: 'changeme'

“Administratora” konta parole iestatīšanai. Tas darbojas tikai pirmajā noklusējuma instalācijā. Lūdzu, skatiet sadaļu [Administratora paroles maiņa pēc pirmās instalēšanas] (# change-admin-password-after-first-install), ja vēlaties to mainīt vēlāk, izmantojot lomu.

Ir ļoti ieteicams rokasgrāmatā neglabāt paroli skaidrā tekstā, bet izmantot [ansible-vault šifrēšanu] (https://docs.ansible.com/ansible/latest/user_guide/vault.html) (iekļauts vai atsevišķā failā, kas ielādēts ar, piemēram, include_vars)

Anonīma piekļuve pēc noklusējuma

    nexus_anonymous_access: false

Pēc noklusējuma anonīma piekļuve ir atspējota. Lasiet vairāk par anonīma piekļuve.

Publisks saimniekdatora nosaukums

    nexus_public_hostname: 'nexus.vm'
    nexus_public_scheme: https

Pilnībā kvalificēts domēna nosaukums un shēma (https vai http), saskaņā ar kuru Nexus instance būs pieejama saviem klientiem.

API piekļuve šai lomai

    nexus_api_hostname: localhost
    nexus_api_scheme: http
    nexus_api_validate_certs: "{{ nexus_api_scheme == 'https' }}"
    nexus_api_context_path: "{{ nexus_default_context_path }}"
    nexus_api_port: "{{ nexus_default_port }}"

Šie mainīgie nosaka, kā loma tiek savienota ar Nexus API nodrošināšanai.
Tikai pieredzējušiem lietotājiem. Jūs, iespējams, nevēlaties mainīt šos noklusējuma iestatījumus

Reversā starpniekservera iestatīšana

    httpd_setup_enable: false
    httpd_server_name: "{{ nexus_public_hostname }}"
    httpd_default_admin_email: "[email protected]"
    httpd_ssl_certificate_file: 'files/nexus.vm.crt'
    httpd_ssl_certificate_key_file: 'files/nexus.vm.key'
    # httpd_ssl_certificate_chain_file: "{{ httpd_ssl_certificate_file }}"
    httpd_copy_ssl_files: true

Komplekts SSL reversais starpniekserveris.
Lai to izdarītu, jāinstalē httpd. Piezīme: kad paredzēts httpd_setup_enable iestatītā vērtībatrue, nexus kontakti 127.0.0.1:8081, tādējādi nē ir tieši pieejama, izmantojot HTTP portu 8081 no ārējās IP adreses.

Izmantotais noklusējuma resursdatora nosaukums ir nexus_public_hostname. Ja kāda iemesla dēļ jums ir nepieciešami citi nosaukumi, varat iestatīt httpd_server_name ar citu nozīmi.

С httpd_copy_ssl_files: true (pēc noklusējuma) iepriekšminētajiem sertifikātiem ir jābūt jūsu rokasgrāmatas direktorijā, un tie tiks kopēti serverī un konfigurēti apache.

Ja vēlaties izmantot serverī esošos sertifikātus, instalējiet httpd_copy_ssl_files: false un norādiet šādus mainīgos:

    # 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 ir neobligāts, un tas ir jāatstāj neiestatīts, ja nevēlaties pielāgot ķēdes failu

    httpd_default_admin_email: "[email protected]"

Iestatiet noklusējuma administratora e-pasta adresi

LDAP konfigurācija

LDAP savienojumi un drošības joma pēc noklusējuma ir atspējoti

    nexus_ldap_realm: false
    ldap_connections: []

LDAP savienojumi, katrs elements izskatās šādi:

    nexus_ldap_realm: true
    ldap_connections:
      - ldap_name: 'My Company LDAP' # used as a key to update the ldap config
        ldap_protocol: 'ldaps' # ldap or ldaps
        ldap_hostname: 'ldap.mycompany.com'
        ldap_port: 636
        ldap_use_trust_store: false # Wether or not to use certs in the nexus trust store
        ldap_search_base: 'dc=mycompany,dc=net'
        ldap_auth: 'none' # or simple
        ldap_auth_username: 'username' # if auth = simple
        ldap_auth_password: 'password' # if auth = simple
        ldap_user_base_dn: 'ou=users'
        ldap_user_filter: '(cn=*)' # (optional)
        ldap_user_object_class: 'inetOrgPerson'
        ldap_user_id_attribute: 'uid'
        ldap_user_real_name_attribute: 'cn'
        ldap_user_email_attribute: 'mail'
        ldap_user_subtree: false
        ldap_map_groups_as_roles: false
        ldap_group_base_dn: 'ou=groups'
        ldap_group_object_class: 'posixGroup'
        ldap_group_id_attribute: 'cn'
        ldap_group_member_attribute: 'memberUid'
        ldap_group_member_format: '${username}'
        ldap_group_subtree: false

LDAP konfigurācijas piemērs anonīmai autentifikācijai (anonīmai saistīšanai), šī ir arī "minimālā" konfigurācija:

    nexus_ldap_realm: true
    ldap_connection:
      - ldap_name: 'Simplest LDAP config'
        ldap_protocol: 'ldaps'
        ldap_hostname: 'annuaire.mycompany.com'
        ldap_search_base: 'dc=mycompany,dc=net'
        ldap_port: 636
        ldap_use_trust_store: false
        ldap_user_id_attribute: 'uid'
        ldap_user_real_name_attribute: 'cn'
        ldap_user_email_attribute: 'mail'
        ldap_user_object_class: 'inetOrgPerson'

LDAP konfigurācijas piemērs vienkāršai autentifikācijai (izmantojot DSA kontu):

    nexus_ldap_realm: true
    ldap_connections:
      - ldap_name: 'LDAP config with DSA'
        ldap_protocol: 'ldaps'
        ldap_hostname: 'annuaire.mycompany.com'
        ldap_port: 636
        ldap_use_trust_store: false
        ldap_auth: 'simple'
        ldap_auth_username: 'cn=mynexus,ou=dsa,dc=mycompany,dc=net'
        ldap_auth_password: "{{ vault_ldap_dsa_password }}" # better keep passwords in an ansible vault
        ldap_search_base: 'dc=mycompany,dc=net'
        ldap_user_base_dn: 'ou=users'
        ldap_user_object_class: 'inetOrgPerson'
        ldap_user_id_attribute: 'uid'
        ldap_user_real_name_attribute: 'cn'
        ldap_user_email_attribute: 'mail'
        ldap_user_subtree: false

LDAP konfigurācijas piemērs vienkāršai autentifikācijai (izmantojot DSA kontu) + grupas, kas kartētas kā lomas:

    nexus_ldap_realm: true
    ldap_connections
      - ldap_name: 'LDAP config with DSA'
        ldap_protocol: 'ldaps'
        ldap_hostname: 'annuaire.mycompany.com'
        ldap_port: 636
        ldap_use_trust_store: false
        ldap_auth: 'simple'
        ldap_auth_username: 'cn=mynexus,ou=dsa,dc=mycompany,dc=net'
        ldap_auth_password: "{{ vault_ldap_dsa_password }}" # better keep passwords in an ansible vault
        ldap_search_base: 'dc=mycompany,dc=net'
        ldap_user_base_dn: 'ou=users'
        ldap_user_object_class: 'inetOrgPerson'
        ldap_user_id_attribute: 'uid'
        ldap_user_real_name_attribute: 'cn'
        ldap_user_email_attribute: 'mail'
        ldap_map_groups_as_roles: true
        ldap_group_base_dn: 'ou=groups'
        ldap_group_object_class: 'groupOfNames'
        ldap_group_id_attribute: 'cn'
        ldap_group_member_attribute: 'member'
        ldap_group_member_format: 'uid=${username},ou=users,dc=mycompany,dc=net'
        ldap_group_subtree: false

LDAP konfigurācijas piemērs vienkāršai autentifikācijai (izmantojot DSA kontu) + grupas, kas dinamiski kartētas kā lomas:

    nexus_ldap_realm: true
    ldap_connections:
      - ldap_name: 'LDAP config with DSA'
        ldap_protocol: 'ldaps'
        ldap_hostname: 'annuaire.mycompany.com'
        ldap_port: 636
        ldap_use_trust_store: false
        ldap_auth: 'simple'
        ldap_auth_username: 'cn=mynexus,ou=dsa,dc=mycompany,dc=net'
        ldap_auth_password: "{{ vault_ldap_dsa_password }}" # better keep passwords in an ansible vault
        ldap_search_base: 'dc=mycompany,dc=net'
        ldap_user_base_dn: 'ou=users'
        ldap_user_object_class: 'inetOrgPerson'
        ldap_user_id_attribute: 'uid'
        ldap_user_real_name_attribute: 'cn'
        ldap_user_email_attribute: 'mail'
        ldap_map_groups_as_roles: true
        ldap_map_groups_as_roles_type: 'dynamic'
        ldap_user_memberof_attribute: 'memberOf'

Privilēģija

    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

Saraksts privilēģijas iestatījumiem. Apskatiet dokumentāciju un GUI, lai pārbaudītu, kuri mainīgie ir jāiestata atkarībā no privilēģiju veida.

Šie elementi ir apvienoti ar šādām noklusējuma vērtībām:

    _nexus_privilege_defaults:
      type: repository-view
      format: maven2
      actions:
        - read

Lomas (tas nozīmē Nexus ierīcē)

    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

Saraksts lomas iestatījumiem.

Biedri

    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

Vietējo (kas nav LDAP) lietotāju/kontu saraksts, ko izveidot programmā Nexus.

Vietējo (kas nav LDAP) lietotāju/kontu saraksts, kas jāizveido ierīcē Nexus.

      nexus_ldap_users: []
      # - username: j.doe
      #   state: present
      #   roles:
      #     - "nx-admin"

Ldap lietotāju/lomu kartēšana. Valsts absent noņems esoša lietotāja lomas, ja tāda jau pastāv.
Ldap lietotāji netiek dzēsti. Mēģinot iestatīt lomu neesošam lietotājam, radīsies kļūda.

Satura atlasītāji

  nexus_content_selectors:
  - name: docker-login
    description: Selector for docker login privilege
    search_expression: format=="docker" and path=~"/v2/"

Papildinformāciju par satura atlasītāju skatiet Dokumentācija.

Lai izmantotu satura atlasītāju, pievienojiet jaunu privilēģiju ar type: repository-content-selector un atbilstošscontentSelector

- name: docker-login-privilege
  type: repository-content-selector
  contentSelector: docker-login
  description: 'Login to Docker registry'
  repository: '*'
  actions:
  - read
  - browse

Blobstores un krātuves

    nexus_delete_default_repos: false

Dzēsiet repozitorijus no nexus instalēšanas sākotnējās noklusējuma konfigurācijas. Šī darbība tiek izpildīta tikai pirmās instalēšanas reizē (kad nexus_data_dir ir atklāts tukšs).

Notiek repozitoriju noņemšana no Nexus noklusējuma noklusējuma konfigurācijas. Šī darbība tiek veikta tikai pirmās instalēšanas laikā (kad nexus_data_dir tukšs).

    nexus_delete_default_blobstore: false

Dzēsiet noklusējuma blobstore no nexus instalēšanas sākotnējās noklusējuma konfigurācijas. To var izdarīt tikai tad, ja nexus_delete_default_repos: true un visām konfigurētajām krātuvēm (skatiet tālāk) ir skaidra blob_store: custom. Šī darbība tiek izpildīta tikai pirmās instalēšanas reizē (kad nexus_data_dir ir atklāts tukšs).

Blob krātuves (bināro artefaktu) noņemšana pēc noklusējuma ir atspējota no sākotnējās konfigurācijas. Lai noņemtu blob krātuvi (bināros artefaktus), izslēdziet nexus_delete_default_repos: true. Šī darbība tiek veikta tikai pirmās instalēšanas laikā (kad nexus_data_dir tukšs).

    nexus_blobstores: []
    # example blobstore item :
    # - name: separate-storage
    #   type: file
    #   path: /mnt/custom/path
    # - name: s3-blobstore
    #   type: S3
    #   config:
    #     bucket: s3-blobstore
    #     accessKeyId: "{{ VAULT_ENCRYPTED_KEY_ID }}"
    #     secretAccessKey: "{{ VAULT_ENCRYPTED_ACCESS_KEY }}"

Blobstores radīt. Blobstore ceļu un repozitorija blobstore nevar atjaunināt pēc sākotnējās izveides (jebkurš atjauninājums šeit tiks ignorēts, veicot atkārtotu nodrošināšanu).

Blobstore konfigurēšana S3 tiek nodrošināta ērtībai, un tā nav daļa no automātiskajiem testiem, ko veicam travis. Lūdzu, ņemiet vērā, ka glabāšana S3 ir ieteicama tikai gadījumiem, kas izvietoti AWS.

Radīšana Blobstores. Krātuves ceļu un krātuves repozitoriju nevar atjaunināt pēc sākotnējās izveides (jebkurš atjauninājums šeit tiks ignorēts, atkārtoti instalējot).

Blob krātuves iestatīšana S3 ir paredzēta ērtībai. Lūdzu, ņemiet vērā, ka S3 krātuve ir ieteicama tikai gadījumiem, kas izvietoti AWS.

    nexus_repos_maven_proxy:
      - name: central
        remote_url: 'https://repo1.maven.org/maven2/'
        layout_policy: permissive
        # maximum_component_age: -1
        # maximum_metadata_age: 1440
        # negative_cache_enabled: true
        # negative_cache_ttl: 1440
      - name: jboss
        remote_url: 'https://repository.jboss.org/nexus/content/groups/public-jboss/'
        # maximum_component_age: -1
        # maximum_metadata_age: 1440
        # negative_cache_enabled: true
        # negative_cache_ttl: 1440
    # example with a login/password :
    # - name: secret-remote-repo
    #   remote_url: 'https://company.com/repo/secure/private/go/away'
    #   remote_username: 'username'
    #   remote_password: 'secret'
    #   # maximum_component_age: -1
    #   # maximum_metadata_age: 1440
    #   # negative_cache_enabled: true
    #   # negative_cache_ttl: 1440

Iepriekš ir konfigurācijas piemērs starpniekserveris Maven.

    nexus_repos_maven_hosted:
      - name: private-release
        version_policy: release
        write_policy: allow_once  # one of "allow", "allow_once" or "deny"

Maven mitinātās krātuves konfigurācija. Negatīvā kešatmiņas konfigurācija nav obligāta, un pēc noklusējuma tiks izmantotas iepriekš minētās vērtības, ja tās tiek izlaistas.

Konfigurācija mitinātās krātuves Maven. Negatīvā kešatmiņas konfigurācija (-1) nav obligāta, un pēc noklusējuma tiks izmantotas iepriekš minētās vērtības, ja tās nav norādītas.

    nexus_repos_maven_group:
      - name: public
        member_repos:
          - central
          - jboss

Konfigurācija grupas Maven.

Visi trīs repozitoriju veidi ir apvienoti ar šādām noklusējuma vērtībām:

    _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

Docker, Pypi, Raw, Rubygems, Bower, NPM, Git-LFS un yum repozitoriju veidi:
redzēt defaults/main.yml šīm opcijām:

Docker, Pypi, Raw, Rubygems, Bower, NPM, Git-LFS un yum krātuves pēc noklusējuma ir atspējotas:
redzēt defaults/main.yml šīm opcijām:

      nexus_config_pypi: false
      nexus_config_docker: false
      nexus_config_raw: false
      nexus_config_rubygems: false
      nexus_config_bower: false
      nexus_config_npm: false
      nexus_config_gitlfs: false
      nexus_config_yum: false

Lūdzu, ņemiet vērā, ka jums, iespējams, būs jāiespējo noteikti drošības tvērumi, ja vēlaties izmantot cita veida repozitorijus, izņemot maven. Pēc noklusējuma tas ir nepatiess

nexus_nuget_api_key_realm: false
nexus_npm_bearer_token_realm: false
nexus_docker_bearer_token_realm: false  # required for docker anonymous access

Remote User Realm var iespējot arī, izmantojot

nexus_rut_auth_realm: true

un nosaukumu var pielāgot, definējot

nexus_rut_auth_header: "CUSTOM_HEADER"

Plānotie uzdevumi

    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"

Plānotie uzdevumi iestatījumiem. typeId un specifisks uzdevumstaskProperties/booleanTaskProperties varat uzminēt vai nu:

no Java tipa hierarhijas org.sonatype.nexus.scheduling.TaskDescriptorSupport
pārlūkprogrammā pārbaudot HTML uzdevuma izveides veidlapu
no AJAX pieprasījumu skatīšanas pārlūkprogrammā, manuāli iestatot uzdevumu.

Uzdevuma rekvizīti ir jādeklarē pareizajā yaml blokā atkarībā no to veida:

taskProperties visiem virknes rekvizītiem (ti, repozitoriju nosaukumiem, repozitoriju nosaukumiem, laika periodiem...).
booleanTaskProperties visiem loģiskajiem rekvizītiem (t.i., galvenokārt izvēles rūtiņām savienojuma izveides uzdevuma GUI).

Dublējumkopijas

      nexus_backup_configure: false
      nexus_backup_cron: '0 0 21 * * ?'  # See cron expressions definition in nexus create task gui
      nexus_backup_dir: '/var/nexus-backup'
      nexus_restore_log: '{{ nexus_backup_dir }}/nexus-restore.log'
      nexus_backup_rotate: false
      nexus_backup_rotate_first: false
      nexus_backup_keep_rotations: 4  # Keep 4 backup rotation by default (current + last 3)

Dublēšana netiks konfigurēta, kamēr nepārslēgsit nexus_backup_configure в true.
Šādā gadījumā ieplānotais skripta uzdevums tiks konfigurēts palaišanai ierīcē Nexus
punktā norādītajā intervālā nexus_backup_cron (pēc noklusējuma 21:00 katru dienu).
Plašāku informāciju skatiet sadaļā [groovy veidne šim uzdevumam] (templates/backup.groovy.j2).
Šis ieplānotais uzdevums ir neatkarīgs no citiem nexus_scheduled_taskskuru jūs
paziņojiet savā rokasgrāmatā.

Ja vēlaties pagriezt/dzēst dublējumus, instalējiet nexus_backup_rotate: true un konfigurējiet to dublējumu skaitu, kurus vēlaties saglabāt nexus_backup_keep_rotations (noklusējums 4).

Izmantojot rotāciju, ja vēlaties ietaupīt papildu vietu diskā dublēšanas procesa laikā,
Jūs varat instalēt nexus_backup_rotate_first: true. Tas konfigurēs iepriekšēju pagriešanu/dzēšanu pirms dublēšanas. Pēc noklusējuma rotācija notiek pēc dublējuma izveides. Lūdzu, ņemiet vērā, ka šajā gadījumā vecās dublējumkopijas
tiks dzēsts pirms pašreizējās dublēšanas izveides.

Atveseļošanās procedūra

Palaist rokasgrāmatu ar parametru -e nexus_restore_point=<YYYY-MM-dd-HH-mm-ss>
(piemēram, 2017-12-17-21-00-00 par 17. gada 2017. decembri plkst. 21:00

Notiek savienojuma noņemšana

Brīdinājums. Tādējādi tiks pilnībā dzēsti jūsu pašreizējie dati. Ja nepieciešams, noteikti izveidojiet dublējumu agrāk

Izmantojiet mainīgo nexus_purgeja jums ir jārestartē no nulles un atkārtoti jāinstalē nexus instance ar noņemtiem visiem datiem.

ansible-playbook -i your/inventory.ini your_nexus_playbook.yml -e nexus_purge=true

Mainiet administratora paroli pēc pirmās instalēšanas

    nexus_default_admin_password: 'admin123'

To nevajadzētu mainīt jūsu rokasgrāmatā. Šis mainīgais tiek aizpildīts ar noklusējuma Nexus administratora paroli pēc pirmās instalēšanas, un tas nodrošina, ka mēs varam mainīt administratora paroli uz nexus_admin_password.

Ja vēlaties mainīt administratora paroli pēc pirmās instalēšanas, varat īslaicīgi nomainīt to uz veco paroli no komandrindas. Pēc pārmaiņām nexus_admin_password savā rokasgrāmatā varat palaist:

ansible-playbook -i your/inventory.ini your_playbook.yml -e nexus_default_admin_password=oldPassword

Telegram kanāls Nexus Sonatype: https://t.me/ru_nexus_sonatype

Aptaujā var piedalīties tikai reģistrēti lietotāji. Ielogoties, lūdzu.

Kādas artefaktu krātuves jūs izmantojat?

Sonatype Nexus ir bezmaksas
Sonatype Nexus samaksāts
Artefaktūra ir bezmaksas
Artifactory samaksāts
osta
Mīkstums

Nobalsoja 9 lietotāji. 3 lietotāji atturējās.

Avots: www.habr.com

Nexus Sonatype instalēšana un konfigurēšana, izmantojot infrastruktūru kā koda pieeju