Proxy repository

Return-Path: X-Original-To: apmail-karaf-commits-archive@minotaur.apache.org Delivered-To: apmail-karaf-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 3C1E91948D for ; Thu, 28 Apr 2016 15:36:17 +0000 (UTC) Received: (qmail 92571 invoked by uid 500); 28 Apr 2016 15:36:17 -0000 Delivered-To: apmail-karaf-commits-archive@karaf.apache.org Received: (qmail 92507 invoked by uid 500); 28 Apr 2016 15:36:16 -0000 Mailing-List: contact commits-help@karaf.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@karaf.apache.org Delivered-To: mailing list commits@karaf.apache.org Received: (qmail 92493 invoked by uid 99); 28 Apr 2016 15:36:16 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd3-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 28 Apr 2016 15:36:16 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd3-us-west.apache.org (ASF Mail Server at spamd3-us-west.apache.org) with ESMTP id 79D77180481 for ; Thu, 28 Apr 2016 15:36:16 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd3-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: 0.999 X-Spam-Level: X-Spam-Status: No, score=0.999 tagged_above=-999 required=6.31 tests=[KAM_LAZY_DOMAIN_SECURITY=1, RP_MATCHES_RCVD=-0.001] autolearn=disabled Received: from mx2-lw-eu.apache.org ([10.40.0.8]) by localhost (spamd3-us-west.apache.org [10.40.0.10]) (amavisd-new, port 10024) with ESMTP id VGaVAuKe4cAu for ; Thu, 28 Apr 2016 15:36:10 +0000 (UTC) Received: from mailrelay1-us-west.apache.org (mailrelay1-us-west.apache.org [209.188.14.139]) by mx2-lw-eu.apache.org (ASF Mail Server at mx2-lw-eu.apache.org) with ESMTP id B059260DBE for ; Thu, 28 Apr 2016 15:36:09 +0000 (UTC) Received: from svn01-us-west.apache.org (svn.apache.org [10.41.0.6]) by mailrelay1-us-west.apache.org (ASF Mail Server at mailrelay1-us-west.apache.org) with ESMTP id 7F0A3E0E74 for ; Thu, 28 Apr 2016 15:36:54 +0000 (UTC) Received: from svn01-us-west.apache.org (localhost [127.0.0.1]) by svn01-us-west.apache.org (ASF Mail Server at svn01-us-west.apache.org) with ESMTP id 4E1A03A01A9 for ; Thu, 28 Apr 2016 15:36:08 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1741460 [6/6] - in /karaf/site/production/manual/cave/latest-3: ./ user-guide/ Date: Thu, 28 Apr 2016 15:36:07 -0000 To: commits@karaf.apache.org From: jbonofre@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20160428153608.4E1A03A01A9@svn01-us-west.apache.org> Added: karaf/site/production/manual/cave/latest-3/proxy-repository.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/cave/latest-3/proxy-repository.html?rev=1741460&view=auto ============================================================================== --- karaf/site/production/manual/cave/latest-3/proxy-repository.html (added) +++ karaf/site/production/manual/cave/latest-3/proxy-repository.html Thu Apr 28 15:36:06 2016 @@ -0,0 +1,572 @@ + + + + + + + +Proxy repository + + + + + + +

Proxy repository

As you can populate repository, you can also proxy an "external" repository.

It means that the artifacts stay on the remote repository, Apache Karaf Cave generates the OBR metadata in the local repository +for the remote artifacts:

karaf@root()> cave:repository-proxy my-repository http://repo1.maven.org/maven2/org/apache/servicemix/bundles/org.apache.servicemix.bundles.commons-lang/

+ + + + + +

Note

The Cave repository will only handle the OBR metadata, it doesn’t monitor the remote repository. It means that you +have to call the cave:proxy-repository command each time the remote repository change (new artifacts, etc).

+ + + + + +

Note

A best practice is to create a Cave repository dedicated for each proxied repository.

The cave:proxy-repository command accepts the filter option, as the cave:populate-repository command:

karaf@root()> cave:repository-proxy --filter .*joda-time-2.* my-repository http://repo2.maven.org/maven2/joda-time/joda-time

+ + + \ No newline at end of file