Artifactory 7.111.12 Self-Hosted

Breaking Change for Artifactory Federation Service

The version of the Artifactory Federation Service (RTFS) that comes with this Artifactory release changes the context path from /artifactory/service/rtfs to /rtfs. This is a breaking change for users who have multiple sites (JPDs) using RTFS. (Users who run RTFS on only one site, and sites that use the legacy Federation service, are unaffected by this change.)Artifactory Federation Service

Users in Self-Hosted environments who have sites running an older version of RTFS should upgrade them to the new version of RTFS as soon as possible to accommodate the new context path. As an interim solution, a set of commands can be added as a workaround to bridge the context path differences between sites using the new version of RTFS and sites using an older version, as described below.

Nginx Configuration

Add this command to the Nginx configuration of a site using the new version of RTFS:

location /artifactory/ {
    if ($request_uri ~ ^/artifactory/service/rtfs/(.*)$ ) {
      proxy_pass       http://router/rtfs/$1;
      break;
    }
    if ( $request_uri ~ ^/artifactory/(.*)$ ) {
      proxy_pass       http://artifactory/artifactory/$1;
    }
    proxy_pass         http://artifactory/artifactory/;
  }

This command instructs Nginx to redirect requests from sites that use the old RTFS context path to the new context path.

Add this command to the Nginx configuration of a site using the old version of RTFS:

location /rtfs/ {
  if ($request_uri ~ ^/rtfs/(.*)$ ) {
      proxy_pass       http://router/artifactory/service/rtfs/$1;
      break;
    }

This command instructs Nginx to redirect requests from sites that use the new RTFS context path to the old context path.

Apache Configuration

Use the following Apache rewrite rule to redirect requests between sites that have a mix of old and new context paths:

RewriteRule "^/artifactory/service/rtfs/(.*)$" "balancer://artifactory/artifactory/service/rtfs/$1" [P,L]

Important Migration Note

When migrating from the legacy Federation service to RTFS, be sure to use version 2.0 of the CLI, which implements the new context path.Migrate to the Artifactory Federation Service