ProHoster > Blog > Идораи > Насб ва танзим кардани Nexus Sonatype бо истифода аз инфрасохтор ҳамчун равиши код

Насб ва танзим кардани Nexus Sonatype бо истифода аз инфрасохтор ҳамчун равиши код

Sonatype Nexus як платформаи ҳамгирошуда мебошад, ки тавассути он таҳиягарон метавонанд вобастагии Java (Maven), Docker, Python, Ruby, NPM, Bower тасвирҳо, бастаҳои RPM, gitlfs, Apt, Go, Nuget прокси, ҳифз ва идора кунанд ва амнияти нармафзори худро паҳн кунанд.

Чаро ба шумо Sonatype Nexus лозим аст?

  • Барои нигоҳ доштани артефактҳои хусусӣ;
  • Барои кэш кардани артефактҳое, ки аз Интернет бор карда мешаванд;

Артефактҳое, ки дар бастаи асосии Sonatype Nexus дастгирӣ мешаванд:

  • Java, Maven (кӯзаи)
  • Доктор
  • Python (pip)
  • Рубин (ганҷ)
  • NPM
  • Бауэр
  • Юм (rpm)
  • gitlfs
  • хом
  • Apt (deb)
  • Go
  • Нугет

Артефактҳои аз ҷониби ҷомеа дастгирӣшаванда:

  • Оҳангсоз
  • Конан
  • CPAN
  • ELPA
  • Helm
  • P2
  • R

Насб кардани Sonatype Nexus бо истифода аз https://github.com/ansible-ThoTeam/nexus3-oss

талаботи

  • Дар бораи истифодаи ansible дар Интернет хонед.
  • ansible насб кунед pip install ansible дар истгоҳи корӣ, ки дар он китоби бозӣ кор мекунад.
  • Set geerlingguy.java дар истгоҳи корӣ, ки дар он китоби бозӣ кор мекунад.
  • Set geerlingguy.apache дар истгоҳи корӣ, ки дар он китоби бозӣ кор мекунад.
  • Ин нақш дар CentOS 7, Ubuntu Xenial (16.04) ва Bionic (18.04), Debian Jessie ва Stretch озмуда шудааст.
  • jmespath Китобхона бояд дар истгоҳи корӣ насб карда шавад, ки дар он китоби бозӣ кор мекунад. Барои насб: sudo pip install -r requirements.txt
  • Файли китоби бозиро (мисол дар зер) ба файли nexus.yml захира кунед
  • Насби nexus-ро иҷро кунед ansible-playbook -i host nexus.yml

Намунаи китоби бозикунии ansible барои насби nexus бе LDAP бо Maven (java), Docker, Python, Ruby, NPM, Bower, RPM ва анбори gitlfs.

---
- 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'] }

Скриншотҳо:

Насб ва танзим кардани Nexus Sonatype бо истифода аз инфрасохтор ҳамчун равиши код

Насб ва танзим кардани Nexus Sonatype бо истифода аз инфрасохтор ҳамчун равиши код

Нақшҳои тағирёбанда

Тағйирёбандаҳои нақш

Тағирёбандаҳо бо арзишҳои пешфарз (ниг default/main.yml):

Тағйирёбандаҳои умумӣ

    nexus_version: ''
    nexus_timezone: 'UTC'

Бо нобаёнӣ, нақш версияи охирини дастраси Nexus-ро насб мекунад. Шумо метавонед версияро тавассути тағир додани тағирёбанда ислоҳ кунед nexus_version. Версияҳои дастрасро дар https://www.sonatype.com/download-oss-sonatype.

Агар шумо ба версияи навтар иваз кунед, нақш кӯшиш мекунад насби Nexus-и шуморо навсозӣ кунад.

Агар шумо версияи кӯҳнаи Nexus-ро аз навтаринаш истифода баред, шумо бояд боварӣ ҳосил кунед, ки шумо хусусиятҳоеро, ки дар версияи насбшуда мавҷуд нестанд, истифода намебаред (масалан, хостинги анбори yum барои Nexus калонтар аз 3.8.0 дастрас аст, git lfs repo. барои nexus калонтар аз 3.3.0 ва ғайра)

nexus timezone номи минтақаи вақти Java аст, ки метавонад дар якҷоягӣ бо ифодаҳои cron барои вазифаҳои nexus_scheduled муфид бошад.

Порти Nexus ва роҳи контекст

    nexus_default_port: 8081
    nexus_default_context_path: '/'

Роҳи порт ва контексти раванди пайвасти Java. nexus_default_context_path ҳангоме ки муқаррар карда мешавад, бояд хатти пешро дар бар гирад, масалан: nexus_default_context_path: '/nexus/'.

Корбар ва гурӯҳи Nexus OS

    nexus_os_group: 'nexus'
    nexus_os_user: 'nexus'

Корбар ва гурӯҳе, ки барои соҳиби файлҳои Nexus истифода мешуданд ва хидматро иҷро мекунанд, аз рӯи нақш офарида мешаванд, агар яке аз онҳо нарасад.

    nexus_os_user_home_dir: '/home/nexus'

Иҷозат диҳед, ки феҳристи хонагии пешфарзро барои корбари Nexus иваз кунед

Феҳристҳои намунаи Nexus

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

Каталогҳои Nexus.

  • nexus_installation_dir дорои файлҳои иҷрошавандаи насбшуда мебошад
  • nexus_data_dir дорои тамоми конфигуратсияҳо, анборҳо ва артефактҳои зеркашидашуда. Роҳҳои фармоишии blobstore nexus_data_dir метавонад танзим карда шавад, ба поён нигаред nexus_blobstores.
  • nexus_tmp_dir ҳамаи файлҳои муваққатиро дар бар мегирад. Роҳи пешфарз барои redhat аз кӯчонида шуд /tmp барои бартараф кардани мушкилоти эҳтимолӣ бо тартиби тозакунии автоматӣ. Ниг. № 168.

Танзими истифодаи хотираи Nexus JVM

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

Инҳо танзимоти пешфарз барои Nexus мебошанд. Лутфан ин арзишҳоро тағир надиҳед Агар шумо нахонда бошед Бахши хотираи талаботи системаи nexus ва намефаҳманд, ки онҳо чӣ кор мекунанд.

Ҳамчун огоҳии дуюм, ин ҷо иқтибос аз ҳуҷҷати боло аст:

Тавсия дода намешавад, ки хотираи тӯдаи JVM аз арзишҳои тавсияшуда зиёд карда шавад, то барои беҳтар кардани кор. Ин метавонад воқеан таъсири баръакс дошта бошад, ки боиси кори нолозим барои системаи оператсионӣ мегардад.

Рамзи администратор

    nexus_admin_password: 'changeme'

Пароли ҳисоби "админ" барои насб. Ин танҳо дар аввалин насби пешфарз кор мекунад. Лутфан [Тағйир додани пароли администратор пас аз насби аввал](# change-admin-password-after-first-install) нигаред, агар шумо хоҳед, ки онро баъдтар бо истифода аз нақш иваз кунед.

Тавсия дода мешавад, ки гузарвожаи худро дар матни равшан дар китоби бозӣ нигоҳ надоред, балки барои истифодаи [encryption-vault] (https://docs.ansible.com/ansible/latest/user_guide/vault.html) (ё дар сатр ё дар файли алоҳидае, ки бо мисол дохил_vars бор карда шудааст)

Дастрасии беном бо нобаёнӣ

    nexus_anonymous_access: false

Дастрасии беном бо нобаёнӣ ғайрифаъол аст. Муфассалтар дар бораи дастрасии беном.

Номи мизбони ҷамъиятӣ

    nexus_public_hostname: 'nexus.vm'
    nexus_public_scheme: https

Номи домен ва схемаи пурраи тахассусӣ (https ё http), ки дар зери он намунаи Nexus барои муштариёнаш дастрас хоҳад буд.

Дастрасии API барои ин нақш

    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 }}"

Ин тағирёбандаҳо назорат мекунанд, ки чӣ гуна нақш ба Nexus API барои таъминот пайваст мешавад.
Танҳо барои корбарони пешрафта. Эҳтимол шумо намехоҳед ин танзимоти пешфарзро тағир диҳед

Насб кардани прокси баръакс

    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

Set Прокси баръакси SSL.
Барои ин шумо бояд httpd-ро насб кунед. Эзоҳ: кай барои httpd_setup_enable арзиши муқарраршудаtrue, алоқаҳои nexus 127.0.0.1:8081, ҳамин тавр не тавассути порти HTTP 8081 аз суроғаи IP берунӣ мустақиман дастрас аст.

Номи пешфарз истифода бурда мешавад nexus_public_hostname. Агар ба шумо бо ягон сабаб номҳои гуногун лозим бошад, шумо метавонед танзим кунед httpd_server_name бо маънои дигар.

С httpd_copy_ssl_files: true (бо нобаёнӣ) сертификатҳои дар боло зикршуда бояд дар феҳристи китобҳои бозиҳои шумо мавҷуд бошанд ва ба сервер нусхабардорӣ карда, дар apache танзим карда мешаванд.

Агар шумо хоҳед, ки сертификатҳои мавҷударо дар сервер истифода баред, насб кунед httpd_copy_ssl_files: false ва тағирёбандаҳои зеринро пешниҳод кунед:

    # 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 ихтиёрӣ аст ва агар шумо намехоҳед, ки файли занҷирро танзим кунед

    httpd_default_admin_email: "[email protected]"

Суроғаи почтаи электронии администраторро муқаррар кунед

Танзимоти LDAP

Пайвастҳои LDAP ва минтақаи амният бо нобаёнӣ ғайрифаъол карда мешаванд

    nexus_ldap_realm: false
    ldap_connections: []

Пайвастҳои LDAP, ҳар як элемент чунин менамояд:

    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 барои аутентификатсияи беном (ҳатмии беном), ин низ конфигуратсияи "ҳадди ақал" аст:

    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 барои тасдиқи оддӣ (бо истифода аз ҳисоби DSA):

    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 барои аутентификатсияи оддӣ (бо истифода аз ҳисоби DSA) + гурӯҳҳое, ки ҳамчун нақшҳо харита шудаанд:

    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 барои аутентификатсияи оддӣ (бо истифода аз ҳисоби DSA) + гурӯҳҳое, ки ба таври динамикӣ ҳамчун нақшҳо харита шудаанд:

    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'

Имтиёзҳо

    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

рӯйхат имтиёзҳо барои танзимот. Ба ҳуҷҷатҳо ва GUI нигоҳ кунед, то бифаҳмед, ки кадом тағирёбандаҳо вобаста ба намуди имтиёз муқаррар карда мешаванд.

Ин унсурҳо бо арзишҳои пешфарзии зерин якҷоя карда мешаванд:

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

Нақшҳо (дар дохили Nexus ин маънои онро дорад)

    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

Рӯйхати корбарон/ҳисобҳои маҳаллӣ (ғайри LDAP) барои эҷод дар nexus.

Рӯйхати корбарон/ҳисобҳои маҳаллӣ (ғайри LDAP), ки дар Nexus эҷод мекунанд. 

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

Харитаи Ldap корбарон / нақшҳо. Давлат absent нақшҳоро аз корбари мавҷуда хориҷ мекунад, агар он аллакай мавҷуд бошад.
Истифодабарандагони Ldap нест карда намешаванд. Кӯшиши таъин кардани нақш барои корбари мавҷуда боиси хатогӣ мегардад.

Интихобкунандагони мундариҷа

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

Барои маълумоти бештар дар бораи интихоби мундариҷа, нигаред Ҳуҷҷатгузорӣ.

Барои истифодаи интихобкунандаи мундариҷа, имтиёзи навро бо type: repository-content-selector ва дахлдорcontentSelector

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

Дӯконҳо ва анборҳо

    nexus_delete_default_repos: false

Анборҳоро аз конфигуратсияи пешфарзии nexus насб кунед. Ин қадам танҳо ҳангоми насби бори аввал иҷро карда мешавад (вақте nexus_data_dir холӣ муайян карда шудааст).

Хориҷ кардани анборҳо аз конфигуратсияи пешфарз барои Nexus. Ин қадам танҳо ҳангоми насби аввал иҷро карда мешавад (вақте nexus_data_dir холӣ).

    nexus_delete_default_blobstore: false

Blobstore-и пешфарзро аз конфигуратсияи ибтидоии пешфарз nexus насб кунед. Инро факат дар сурате ичро кардан мумкин аст nexus_delete_default_repos: true ва ҳама анборҳои танзимшуда (ба поён нигаред) дорои возеҳ мебошанд blob_store: custom. Ин қадам танҳо ҳангоми насби бори аввал иҷро карда мешавад (вақте nexus_data_dir холӣ муайян карда шудааст).

Хориҷ кардани нигаҳдории blob (артефактҳои дуӣ) ба таври нобаёнӣ аз конфигуратсияи аввала ғайрифаъол аст. Барои нест кардани нигаҳдории blob (артефактҳои дуӣ), хомӯш кунед nexus_delete_default_repos: true. Ин қадам танҳо ҳангоми насби аввал иҷро карда мешавад (вақте nexus_data_dir холӣ).

    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 }}"

Мағозаҳо сохтан. Роҳи blobstore ва анбори blobstore пас аз офариниши аввала навсозӣ карда намешавад (ҳар як навсозӣ дар ин ҷо ҳангоми дубора таъминкунӣ сарфи назар карда мешавад).

Танзими blobstore дар S3 ҳамчун роҳат таъмин карда шудааст ва қисми санҷишҳои автоматие, ки мо дар Травис иҷро мекунем, нест. Лутфан қайд кунед, ки нигоҳдорӣ дар S3 танҳо барои мисолҳое, ки дар AWS ҷойгир шудаанд, тавсия дода мешавад.

Эҷод Мағозаҳо. Роҳи нигоҳдорӣ ва анбори нигаҳдорӣ пас аз эҷоди аввала навсозӣ карда намешавад (ҳар гуна навсозӣ дар ин ҷо ҳангоми насби дубора сарфи назар карда мешавад).

Насб кардани нигаҳдории blob дар S3 ҳамчун роҳат таъмин карда мешавад. Лутфан таваҷҷӯҳ намоед, ки нигаҳдории S3 танҳо барои мисолҳое, ки дар 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

Дар боло як конфигуратсияи намунавӣ оварда шудааст сервери прокси Мавен.

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

Maven анборҳои ҷойгиршуда конфигуратсия. Конфигуратсияи кэш манфӣ ихтиёрӣ аст ва агар нодида гирифта шавад, ба арзишҳои дар боло зикршуда муқаррар карда мешавад.

Танзимот анборҳои ҷойгиршуда Мавен. Конфигуратсияи кэш манфии (-1) ихтиёрӣ аст ва агар нишон дода нашуда бошад, ба арзишҳои дар боло зикршуда муқаррар карда мешавад.

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

Танзимот гурӯҳҳо Мавен.

Ҳама се намуди анбор бо арзишҳои пешфарзии зерин якҷоя карда мешаванд:

    _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 ва yum:
дидан defaults/main.yml барои ин вариантҳо:

Репозиторийҳои Docker, Pypi, Raw, Rubygems, Bower, NPM, Git-LFS ва yum ба таври нобаёнӣ хомӯш карда шудаанд:
Нигоҳ кунед defaults/main.yml барои ин вариантҳо:

      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

Лутфан таваҷҷӯҳ намоед, ки агар шумо хоҳед, ки намудҳои дигари анборҳоро ғайр аз maven истифода баред, ба шумо лозим меояд, ки доираи муайяни амниятиро фаъол созед. Ин ба таври нобаёнӣ нодуруст аст

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

Бо истифода аз Realm корбари дурдаст низ метавонад фаъол карда шавад

nexus_rut_auth_realm: true

ва сарлавҳаро тавассути муайян кардан танзим кардан мумкин аст

nexus_rut_auth_header: "CUSTOM_HEADER"

Вазифаҳои ба нақша гирифташуда

    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"

Вазифаҳои ба нақша гирифташуда барои танзимот. typeId ва вазифаи мушаххасtaskProperties/booleanTaskProperties шумо метавонед тахмин кунед:

  • аз иерархияи навъи Java org.sonatype.nexus.scheduling.TaskDescriptorSupport
  • тафтиши шакли эҷоди вазифаи HTML дар браузери шумо
  • аз дидани дархостҳои AJAX дар браузер ҳангоми ба таври дастӣ насб кардани вазифа.

Хусусиятҳои вазифа бояд дар блоки дурусти yaml вобаста ба намуди онҳо эълон карда шаванд:

  • taskProperties барои ҳама хосиятҳои сатр (яъне номҳои репозиторий, номҳои анбор, давраҳои вақт...).
  • booleanTaskProperties барои ҳама хосиятҳои мантиқӣ (яъне асосан қуттиҳои қайдкуниро дар GUI вазифаи эҷоди nexus).

Нусхаҳои эҳтиётӣ

      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)

То он даме, ки шумо иваз кунед, нусхабардорӣ танзим карда намешавад nexus_backup_configure в true.
Дар ин ҳолат, вазифаи скрипти ба нақша гирифташуда барои иҷро дар Nexus танзим карда мешавад
дар фосилаи пешбинишуда nexus_backup_cron (пешфарз 21:00 ҳар рӯз).
Барои тафсилот ба [Шаблони зебо барои ин вазифа](templates/backup.groovy.j2) нигаред.
Ин вазифаи ба нақша гирифташуда аз дигарон вобаста аст nexus_scheduled_tasksки шумо
дар китоби бозиатон эълон кунед.

Агар шумо хоҳед, ки нусхаҳои эҳтиётиро гардонед/нест кунед, насб кунед nexus_backup_rotate: true ва шумораи нусхаҳоеро, ки шумо мехоҳед захира кунед, танзим кунед nexus_backup_keep_rotations (пешфарз 4).

Ҳангоми истифодаи гардиш, агар шумо хоҳед, ки дар ҷараёни нусхабардорӣ фазои иловагии дискро сарфа кунед,
Шумо метавонед насб кунед nexus_backup_rotate_first: true. Ин пеш аз нусхабардорӣ гардиш/нест карданро танзим мекунад. Бо нобаёнӣ, гардиш пас аз эҷоди нусхабардорӣ сурат мегирад. Лутфан қайд кунед, ки дар ин ҳолат нусхаҳои кӯҳна
пеш аз сохтани нусхаи ҷории он нест карда мешавад.

Раванди барқарорсозӣ

Китоби бозиро бо параметр иҷро кунед -e nexus_restore_point=<YYYY-MM-dd-HH-mm-ss>
(масалан, 2017-12-17-21-00-00 барои 17 декабри 2017, соати 21:00

Хориҷ кардани алоқа

Огоҳӣ: Ин маълумоти ҷории шуморо комилан нест мекунад. Боварӣ ҳосил кунед, ки агар лозим бошад, пештар нусхабардорӣ кунед

Тағирёбандаро истифода баред nexus_purgeагар ба шумо лозим ояд, ки аз сифр бозоғоз намоед ва намунаи nexus-ро бо тамоми маълумоти тозашуда аз нав насб кунед.

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

Пас аз насби аввал пароли администраторро тағир диҳед

    nexus_default_admin_password: 'admin123'

Ин набояд дар китоби бозии шумо тағир дода шавад. Ин тағирёбанда ҳангоми насби аввал бо пароли администратори Nexus пур карда мешавад ва кафолат медиҳад, ки мо метавонем пароли администраторро ба nexus_admin_password.

Агар шумо хоҳед, ки пас аз насби аввал пароли администраторро иваз кунед, шумо метавонед онро муваққатан ба пароли кӯҳна аз сатри фармон иваз кунед. Пас аз тағир nexus_admin_password дар китоби бозии худ шумо метавонед иҷро кунед:

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

Канали Telegram дар Nexus Sonatype: https://t.me/ru_nexus_sonatype

Танҳо корбарони сабтиномшуда метавонанд дар пурсиш иштирок кунанд. даромад, Лутфан.

Кадом анбори артефактҳоро шумо истифода мебаред?

  • Sonatype Nexus ройгон аст

  • Sonatype Nexus пардохт кардааст

  • Артефактура ройгон аст

  • Артефактура пардохта мешавад

  • Харбор

  • Тарбуз

9 корбар овоз доданд. 3 корбар худдорӣ карданд.

Манбаъ: will.com

Илова Эзоҳ