Skip to content

Latest commit

 

History

History
86 lines (55 loc) · 2.92 KB

developing.md

File metadata and controls

86 lines (55 loc) · 2.92 KB

Developing

Table Of Contents

Requirements

Also, there is a good amount of information available at Bundle Development.

You may also find it helpful to configure your IDE to use the Sonatype Code style.

Download

Pre-compiled plugin files can be found on the releases page.

Building

To build the project and generate the bundle use Maven:

mvn clean package -PbuildKar

If everything checks out, the bundle for ansiblegalaxy should be available in the target folder.

Build Docker image

To build a Nexus Docker image with this plugin bundled, run the following:

docker build -t nexus-repository-ansiblegalaxy .

The above will require the Docker build process to download Maven dependencies for each build. To simplify the build process during development, use the following instead:

mvn clean package -PbuildKar
docker build -f Dockerfile-dev -t nexus-repository-ansiblegalaxy .

Run as a Docker container

After building the Docker image, you can run as follows:

docker run -d -p 8081:8081 --name nexus-repository-ansiblegalaxy nexus-repository-ansiblegalaxy

For further information like how to persist volumes check out the GitHub repo for our official image.

After allowing some time to spin up, the application will be available from your browser at http://localhost:8081.

To read the generated admin password for your first login to the web UI, you can use the command below against the running docker container:

docker exec -it nexus-repository-ansiblegalaxy cat /nexus-data/admin.password && echo

For simplicity, you should check Enable anonymous access in the prompts following your first login.

Installing

See installing the plugin.

Testing

Configure ansible-galaxy to use your local Nexus server, such as:

ansible-galaxy collection install azure.azcollection -s http://localhost:8081/repository/ansible/

See Ansible Galaxy Configuration documentation for more detail.

It may be helpful to install Ansible into a virtual environment. Full detail on doing so is outside the scope of this documentation, but the following command may be useful, which creates a local virtual environment and install Ansible:

python3 -m venv venv && . venv/bin/activate && pip3 install --upgrade pip && pip3 install wheel && pip3 install ansible