Nexusで自前のMavenリポジトリを建ててsbtから使用する

Scala現場でプロジェクトの依存関係をクローズドなMavenリポジトリで管理できないかという話が上がったので、ひとまずローカル上で簡易に検証した内容を備忘として残します。

---

ローカルにリポジトリサーバを建てる

本番用のリポジトリサーバは別途現場で用意される。
ローカルでの検証は手軽にNexus公式のDockerイメージを使用。

Nexusサーバ作成～ログイン

適当に作業フォルダを掘ってdocker-compose.ymlを下記の通り作成。

$ mkdir nexus && cd nexus
$ vim docker-compose.yml

docker-compose.yml

version: '2'
services:
  nexus3:
    image: sonatype/nexus3
    volumes:
      - nexus-data:/nexus-data
    ports:
      - 8081:8081
volumes:
  nexus-data:

作成したらDockerコンテナを起動、しばし待機。

$ docker-compose up -d
Creating network "nexus_default" with the default driver
Creating nexus_nexus3_1 ...
Creating nexus_nexus3_1 ... done

コンテナのログに下記のように表示されたら起動完了。

$ docker-compose logs
...
nexus3_1  | -------------------------------------------------
nexus3_1  |
nexus3_1  | Started Sonatype Nexus OSS 3.6.2-01
nexus3_1  |
nexus3_1  | -------------------------------------------------

http://localhost:8081/にアクセスするとNexusの管理コンソールが表示される。

右上のリンクから「Sign In」
※デフォルトで次の管理ユーザ／パスワードが用意されている：[admin/admin123]

⇒ログイン後、必要に応じて「設定」＞「Users」からユーザを作成。(今回は検証用なので省略)

Mavenリポジトリ作成

自前のライブラリを登録するMavenリポジトリを作成する。

「repositories」＞「Create repository」＞「maven2 (hosted)」

Snapshot用とRelease用をそれぞれ作成。

参照用に上記リポジトリをまとめたグループを作成。
「repositories」＞「Create repository」＞「maven2 (group)」

※maven-central等の追加はお好みで。

---

sbtからリポジトリを使用する

自作したリポジトリをScalaプロジェクトで利用するにはbuild.sbtに下記のように設定する。

build.sbt

organization := "com.example"

name := "scala-libs-sample"

version := "0.0.1-SNAPSHOT"

////////////////////////////////////////////////////////////////////////////////////
// My Hosted Repository
val myrepos = "http://localhost:8081/"
// リポジトリ認証情報 => 後述の[~/.sbt/.credentials]の内容を読み込む
credentials += Credentials(Path.userHome / ".sbt" / ".credentials")

// リポジトリへデプロイする側の設定
publishMavenStyle := true
publishArtifact in Test := false
pomIncludeRepository := { _ => false }
publishTo := {
  if (isSnapshot.value)
    Some("snapshots" at myrepos + "repository/my-snapshots")
  else
    Some("releases"  at myrepos + "repository/my-releases")
}

// モジュールを利用する側の設定
resolvers += "Nexus" at myrepos + "repository/my-repo-group/"
libraryDependencies += "com.example" % "scala-libs-sample" % "0.0.1-SNAPSHOT"

リポジトリサーバの認証情報は、ホームディレクトリに.sbt/.credentialsファイルを作成し下記のように記載する。（※ユーザ名などは適宜変更）

~/.sbt/.credentials

realm=Sonatype Nexus Repository Manager
host=localhost
user=admin
password=admin123

設定に問題が無ければpublishコマンドでサーバにモジュールがデプロイされるはず＞

$ sbt publish
...
[info]  published scala-libs-sample_2.10 to http://localhost:8081/repository/my-snapshots/com/example/scala-libs-sample_2.10/0.0.1-SNAPSHOT/scala-libs-sample_2.10-0.0.1-SNAPSHOT.pom
[info]  published scala-libs-sample_2.10 to http://localhost:8081/repository/my-snapshots/com/example/scala-libs-sample_2.10/0.0.1-SNAPSHOT/scala-libs-sample_2.10-0.0.1-SNAPSHOT.jar
[info]  published scala-libs-sample_2.10 to http://localhost:8081/repository/my-snapshots/com/example/scala-libs-sample_2.10/0.0.1-SNAPSHOT/scala-libs-sample_2.10-0.0.1-SNAPSHOT-sources.jar
[info]  published scala-libs-sample_2.10 to http://localhost:8081/repository/my-snapshots/com/example/scala-libs-sample_2.10/0.0.1-SNAPSHOT/scala-libs-sample_2.10-0.0.1-SNAPSHOT-javadoc.jar
[success] Total time: 2 s, completed 2017/12/16 23:14:43