About

The GÉANT Software Repository is based on Artifactory (http://www.jfrog.com/products.php) with Pro Power Pack ( http://www.jfrog.com/pro-features.php). Artifactory provide base Maven/Gradle repository functionality: you can download artefacts and deploy own snapshot and release artefacts like in any repository. It can be used as mirror for any external repository. Also it provide nice GUI to manage your artefacts, deploy files manually and integration Bamboo.  Integration with Bamboo (https://ci.geant.org) allow eg. performing License Check process after artefacts deploy, deployment from Bamboo with global defined credentials etc.

Artifactory Pro Power Pack allow us to support different types of repository wider adopted in software development, see available predefined repositories types bellow:

How to access

URL: https://artifactory.software.geant.org

Artifactory uses fedrated authentication. During login process you must choose your Identity Provider. After successful authentication you will be redirect  back to Artifactory home page. 

Login with GÉANT AAI

  1. Go to https://artifactory.software.geant.org/
  2. Click the Log in link in the top right corner



  3. Click on the GÉANT AAI
  4. You will be redirect to login.geant.org where you can choose your Identity Provider and use it to log in.



    If you are logging in for the first time using GÉANT AAI Service, you will see the message "You tried to access (a service via) GÉANT AAI Service, but we couldn't find a registration Let's fix that!" and you have to register first. To do so, please follow the instructions from Registration in GÉANT AAI Service


  5. After successful login you will be redirect to Artifactory main page

Get access to specyfic repository

To get access to specific repository:

  1. Log in to https://artifactory.software.geant.org
  2. Send access request - create issue on Help Desk Portal or send e-mail at help@software.geant.org You have to provide us:

For "non GUI" access to repository for automated deployment tools (Jenkins, Bitbucket), you can:

Short guides

How to use Artifactory as Maven repository

GÉANT Artifactory Repositories

Artifactory allow to create three repository types: local, remote and virtual. In GÉANT we use all of them, to understood how it works read http://wiki.jfrog.org/confluence/display/RTF/Understanding+Repositories page on Artifactory documentation page.

Each GÉANT development projects have their own local repositories:

Working with Repository in Maven

1. Request for project internal repositories in Help Desk Portal (https://jira.software.geant.org/servicedesk/customer/portal/2)
2. Setting Up a Maven Deployment Descriptor You can follow: http://wiki.jfrog.org/confluence/display/RTF/Configuring+Deployment or:
2.1. Provide configuration in main POM file eg.:


<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.
0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>net.geant.ishare</groupId>
    <artifactId>ishare</artifactId>
    <packaging>pom</packaging>
    <version>2.0.1-SNAPSHOT</version>
    <name>${project.artifactId}</name>
    <description>I-SHARe Project</description>
    <distributionManagement>
        <repository>
            <id>GEANT Artifactory</id>
            <name>GEANT Artifactory ishare-release</name>
            <url>https://artifactory.software.geant.org/artifactory/ishare-release-local</url>
        </repository>
        <snapshotRepository>
            <id>GEANT Artifactory</id>
            <name>GEANT Artifactory ishare-snapshots</name>
            <url>https://artifactory.software.geant.org/artifactory/ishare-snapshot-local</url>
        </snapshotRepository>
    </distributionManagement>
</project>


2.2. Provide your credentials in settings.xml file.

3. Try to deploy snapshot artefacts.

Reference:

Using Artifactory as maven repositories mirror

Easiest way to use GN Artifactory as global maven repositories mirror is to define profile in your POM file. If you want always use GN Artifactory you can activate profile by default. See below example how to configure it.:
...
         <profile>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <id>artifactory</id>
            <repositories>
                <repository>
                    <id>central</id>
                    <name>libs-release</name>
                    <url>https://artifactory.software.geant.org/artifactory/repo</url>
                </repository>
            </repositories>
            <pluginRepositories>
                <pluginRepository>
                    <id>central</id>
                    <name>plugins-release</name>
                    <url>https://artifactory.software.geant.net/artifactory/repo</url>
                </pluginRepository>
            </pluginRepositories>
        </profile>
...


How to use Artifactory as docker registry

Artifactory can be used to serve Docker images like Docker Registry. It is just another type of repository and could be browsed and managed in Artifactory web dashboard.

Address: artifactory.software.geant.org/<REPO_NAME>/<IMAGE_NAME>:<TAG>

How to use with Docker client

  1. Login

    docker login artifactory.software.geant.org


    And provide your Artifactory username and password

    To manually set your credentials copy the following snippet to your ~/.docker/config.json file.

    {
        "auths": {
            "https://artifactory.software.geant.org: {
                "auth": "<USERNAME>:<PASSWORD>",
                "email": "youremail@email.com"
            }
        }
    }


  2. Push image to registry
    To push an image tag an image using the docker tag and then docker push command.

    docker tag <MY_IMAGE_ID> artifactory.software.geant.org/<REPO_NAME>/<IMAGE_NAME>:<TAG>
    docker push artifactory.software.geant.org/<REPO_NAME>/<IMAGE_NAME>:<TAG>


  3. Pull image

    docker pull artifactory.software.geant.org/<REPO_NAME>/<IMAGE_NAME>:<TAG>


Related articles

The JFrog Academy provides free, unlimited access to On-Demand Online Training, some of them are dedicated to DevOps and could help you to get deep knowledge about useful Artifactory features and also build automation and DevOps best practices:

  • Artifactory Basics (60m)
  • DevOps Pipelines with Artifactory (120m)

See more at: https://academy.jfrog.com


Related articles appear here based on the labels you select. Click to edit the macro and add or change labels.



Related issues