CargoないしRustのパッケージレジストリといえばcrates.ioで、ここにpublishしておけばcargo install ...でインストール可能になるわけですが、Rustで書いたオレオレツールやClosedな環境でのみ使うツールを公開するわけにはいかないので、なにかいい方法はないかな〜と探してみて一番楽そうだった方法のメモ。

あくまで「Closedな環境」が前提。Publicにしたらやばい。

準備

「Cargo Alternate Registryを使って」とまるで自作したかのようないい振りだけど感謝しながら既成ツールを使う。

Cargoは使える状態だとして、CargoリポジトリのWikiに記載されていたcargo-http-registryを使う。

cargo install cargo-http-registry

やる

レジストリとして使うディレクトリへのパスを渡すだけ。

お試しで/tmpあたり作っておけば良さそう。パスが存在しなければ勝手に作ってくれる。

cargo-http-registry /tmp/registry

これでレジストリの準備はおわり。

レジストリを使うための設定

このレジストリをcargoコマンドが認識できるように~/.cargo/config.tomlに次を追記しておく。

ポートは環境によって変わりそう。cargo-http-registryを実行して生成されたconfig.jsonに記載されたポートに合わせる。

# ~/.cargo/config.toml
[registries]
my-registry = { index = "http://127.0.0.1:62159/git" }

fileプロトコルでも使えるみたいなので、ファイルサーバーにレジストリを設置しておくみたいな場合はそっちでも良さそう。

クレート公開側の設定

cargo publishで公開したいので、そのためのアレコレ。

自前レジストリにログインする

ログインする。

> cargo login --registry=my-registry                 
please paste the token found on http://127.0.0.1:62159/me below
<何でもいいので適当に入れておく>
       Login already logged in

トークンはこの際何でもいいので適当に入れる。Login already logged inになればOK。

適当なクレートを公開してみる

ハローワールドを公開してハローワールドしてみる。

cargo new my_crate_bin && cd my_crate_bin
cargo publish --registry=my-registry --allow-dirty

正しく公開できるとcargo-http-registryで指定したディレクトリ直下にmy_crate_bin-0.1.0.crateが爆誕しているはず。

公開方法としてはコレで良いですが、公開するであろうパッケージのCargo.tomlに次を追記しておくと、crates.ioに万が一にでも上がってしなうことはなくなる（そもそもログインしていなければ上がることはないが）。

publish = ["my-registry"]

cargo-http-registryのREADMEで初めて知った。

オレオレクレートを使ってみる

自分以外の誰かが使うことを想定して。

もちろん利用者も~/.cargo/config.tomlに自前レジストリを使うための設定が必要になる。

また、（環境変数でもコントロール可能なので必須ではないが）HTTPプロトコルでアクセスするならnet.git-fetch-with-cliをtrueにしておく。

# ~/.cargo/config.toml
[registries]
my-registry = { index = "http://127.0.0.1:62159/git" }

[net]
git-fetch-with-cli = true

これで利用者側の準備おわり。インストールしてみる。

cargo install my_crate_bin --registry=my-registry

# net.git-fetch-with-cliの設定を書かないままHTTPでやり取りするならこっち
CARGO_NET_GIT_FETCH_WITH_CLI=true cargo install my_crate_bin --registry=my-registry

インストールできたはず。

> my_crate_bin
Hello, world!

OK。もういらんので消す。

> cargo uninstall my_crate_bin                     
    Removing /Users/sk/.cargo/bin/my_crate_bin

おわりに

Cargo Wikiに記載されている代替ツールはいくつか検討してみたが、（自作するモチベーションはなくて）コレが一番自分のユースケースにあってそうだった。

（Crate？Package？わからん）