Rust 1.58.1 Toolset の使用

Red Hat Developer Tools 1

1.58.1 のインストールおよび使用

概要

Rust Toolset は、Red Hat Enterprise Linux (RHEL) オペレーティングシステム上の開発者向けの Red Hat 製品です。本書では、Rust Toolset の概要、さまざまなバージョンの Rust ツールを起動して使用する方法、および詳細な情報を含むリソースを検索する方法を説明します。

多様性を受け入れるオープンソースの強化
リンクのコピー

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、今後の複数のリリースで段階的に用語の置き換えを実施して参ります。詳細は、Red Hat CTO である Chris Wright のメッセージをご覧ください。

第1章 Rust Toolset
リンクのコピー

Rust Toolset は、Red Hat Enterprise Linux (RHEL) 上の開発者向けの Red Hat 製品です。Rust プログラミング言語、Rust パッケージマネージャー Cargo、rustfmt フォーマットツール、および必要なライブラリーに rustc コンパイラーを提供します。

Rust Toolset は、Red Hat Developer Tools for Red Hat Enterprise Linux 7 の一部として配布されています。Red Hat Enterprise Linux 8 では、Rust Toolset はモジュールとして利用できます。Rust Toolset は、Red Hat Enterprise Linux 9 のパッケージとして利用できます。

1.1. Rust Toolset コンポーネント
リンクのコピー

以下のコンポーネントは、Rust Toolset の一部として利用できます。

Expand

名前	バージョン	説明
`rust`	1.58.1	LLVM 用の Rust コンパイラーフロントエンド。
`cargo`	1.58.1	Rust のビルドシステムおよび依存関係マネージャー。
`rustfmt`	1.58.1	Rust コードの自動フォーマットを行うためのツール。

1.2. Rust Toolset の互換性
リンクのコピー

Rust Toolset は、以下のアーキテクチャーで Red Hat Enterprise Linux 7、Red Hat Enterprise Linux 8、および Red Hat Enterprise Linux 9 で利用できます。

AMD および Intel 64 ビット
64 ビット ARM (RHEL 8 および RHEL 9)
IBM Power Systems、リトルエンディアン
IBM Power Systems、ビックエンディアン (RHEL 7 のみ)
64 ビット IBM Z

1.3. Red Hat Enterprise Linux 7 での Rust Toolset へのアクセス
リンクのコピー

Rust Toolset を Red Hat Enterprise Linux 7 にインストールするには、Red Hat Developer Tools リポジトリーおよび Red Hat Software Collections リポジトリーにアクセスして有効にする必要があります。
これらのリポジトリーがすでにシステムに割り当てられている場合は、Rust Toolset のインストールを参照してください。

手順

以下を実行して Wget をインストールします。
```
yum install wget
```
```
# yum install wget
```
Copy to Clipboard Toggle word wrap
以下を実行して最新のサブスクリプションデータをダウンロードします。
```
subscription-manager refresh
```
```
# subscription-manager refresh
```
Copy to Clipboard Toggle word wrap
以下を実行してシステムを登録します。
```
subscription-manager register
```
```
# subscription-manager register
```
Copy to Clipboard Toggle word wrap
グラフィカルユーザーインターフェイス (GUI) を使用してシステムを登録するには、システムの登録および登録解除ガイドを参照してください。
利用可能なサブスクリプションの一覧を表示し、以下のコマンドを実行してプール ID を特定します。
```
subscription-manager list --available
```
```
# subscription-manager list --available
```
Copy to Clipboard Toggle word wrap
Pool ID で始まる行でプール ID を検索します。
以下を実行して、Red Hat Developer Tools リポジトリーへのアクセスを提供するサブスクリプションをシステムに割り当てます。
```
subscription-manager attach --pool=<pool ID from the subscription>
```
```
# subscription-manager attach --pool=<pool ID from the subscription>
```
Copy to Clipboard Toggle word wrap
- <pool ID from the subscription> を、直前の手順で特定したプール ID に置き換えます。
以下を実行して、システムに割り当てられているサブスクリプションを確認します。
```
sudo subscription-manager list --consumed
```
```
# sudo subscription-manager list --consumed
```
Copy to Clipboard Toggle word wrap
以下を実行して rhel-7-variant-devtools-rpms リポジトリーを有効にします。
```
subscription-manager repos --enable rhel-7-<variant>-devtools-rpms
```
```
# subscription-manager repos --enable rhel-7-<variant>-devtools-rpms
```
Copy to Clipboard Toggle word wrap
- <variant> を、Red Hat Enterprise Linux システムのバリアント (server または workstation) に置き換えます。
  server を使用して、最も幅広い開発ツールにアクセスします。
以下を実行して rhel-variant-rhscl-7-rpms リポジトリーを有効にします。
```
subscription-manager repos --enable rhel-<variant>-rhscl-7-rpms
```
```
# subscription-manager repos --enable rhel-<variant>-rhscl-7-rpms
```
Copy to Clipboard Toggle word wrap
- <variant> を、Red Hat Enterprise Linux システムのバリアント (server または workstation) に置き換えます。

以下を実行して Red Hat Developer Tools GPG キーをシステムに追加します。

cd /etc/pki/rpm-gpg
wget -O RPM-GPG-KEY-redhat-devel https://www.redhat.com/security/data/a5787476.txt
rpm --import RPM-GPG-KEY-redhat-devel

# cd /etc/pki/rpm-gpg
# wget -O RPM-GPG-KEY-redhat-devel https://www.redhat.com/security/data/a5787476.txt
# rpm --import RPM-GPG-KEY-redhat-devel

Copy to Clipboard

Toggle word wrap

1.4. Rust Toolset のインストール
リンクのコピー

すべての開発ツール、デバッグツール、および依存パッケージを含む Rust Toolset をインストールするには、以下の手順を実行します。Rust Toolset には、LLVM Toolset の依存関係があることに注意してください。

前提条件

Red Hat Enterprise Linux 7 で、Red Hat Developer Tools コンテンツセットへのアクセスを提供するサブスクリプションがシステムに割り当てられている。
サブスクリプションを割り当てるには、Red Hat Enterprise Linux 7 での Rust Toolset へのアクセスを参照してください。
利用可能な Red Hat Enterprise Linux のすべての更新がインストールされている。

手順

Red Hat Enterprise Linux 7 に、rust-toolset-1.58 コレクションをインストールします。

yum install rust-toolset-1.58

# yum install rust-toolset-1.58

Copy to Clipboard

Toggle word wrap

Red Hat Enterprise Linux 8 で、以下のコマンドを実行して rust-toolset モジュールをインストールします。

yum module install rust-toolset

# yum module install rust-toolset

Copy to Clipboard

Toggle word wrap

Red Hat Enterprise Linux 9 で、以下のコマンドを実行して rust-toolset パッケージをインストールします。

dnf install rust-toolset

# dnf install rust-toolset

Copy to Clipboard

Toggle word wrap

1.5. Rust ドキュメントのインストール
リンクのコピー

The Rust Programming Language ガイドは、インストール可能なドキュメントとして利用できます。

前提条件

Rust Toolset がインストールされている。
詳細は、Rust Toolset のインストールを参照してください。

手順

rust-doc パッケージをインストールするには、以下のコマンドを実行します。

Red Hat Enterprise Linux 7 の場合
```
yum install rust-toolset-1.58-rust-doc
```
```
# yum install rust-toolset-1.58-rust-doc
```
Copy to Clipboard Toggle word wrap
Rust プログラミング言語 のガイドは /opt/rh/rust-toolset-1.58/root/usr/share/doc/rust/html/index.html にあります。
すべての Rust コードパッケージの API ドキュメントは、/opt/rh/rust-toolset-1.58/root/usr/share/doc/rust/html/std/index.html にあります。
Red Hat Enterprise Linux 8 の場合
```
yum install rust-doc
```
```
# yum install rust-doc
```
Copy to Clipboard Toggle word wrap
The Rust Programming Language ガイドは、/usr/share/doc/rust/html/index.html にあります。
すべての Rust コードパッケージの API ドキュメントは、/usr/share/doc/rust/html/std/index.html にあります。
Red Hat Enterprise Linux 9 の場合
```
dnf install rust-doc
```
```
# dnf install rust-doc
```
Copy to Clipboard Toggle word wrap
The Rust Programming Language ガイドは、/usr/share/doc/rust/html/index.html にあります。
すべての Rust コードパッケージの API ドキュメントは、/usr/share/doc/rust/html/std/index.html にあります。

1.6. Cargo ドキュメントのインストール
リンクのコピー

Cargo (Rust のパッケージマネージャー) ガイドは、Cargo のインストール可能なドキュメントとして利用できます。

前提条件

Rust Toolset がインストールされている。
詳細は、Rust Toolset のインストールを参照してください。

手順

cargo-doc パッケージをインストールするには、以下のコマンドを実行します。
- Red Hat Enterprise Linux 7 の場合
  # yum install rust-toolset-1.58-cargo-doc
  Copy to Clipboard Toggle word wrap
  Cargo のガイド は、/opt/rh/rust-toolset-1.58/root/usr/share/doc/cargo/html/index.html にあります。
- Red Hat Enterprise Linux 8 の場合
  # yum install cargo-doc
  Copy to Clipboard Toggle word wrap
  Cargo (Rust のパッケージマネージャー) のガイドは、/usr/share/doc/cargo/html/index.html にあります。
- Red Hat Enterprise Linux 9 の場合
  # dnf install cargo-doc
  Copy to Clipboard Toggle word wrap
  Cargo (Rust のパッケージマネージャー) のガイドは、/usr/share/doc/cargo/html/index.html にあります。

第2章 Cargo ビルドツール
リンクのコピー

Cargo は、Rust コンパイラー rustc と、パッケージおよび依存関係マネージャーのビルドツールおよびフロントエンドです。これにより、Rust プロジェクトは、特定のバージョン要件での依存関係の宣言、完全な依存関係グラフの解決、パッケージのダウンロード、プロジェクト全体のビルドとテストが可能となります。

Rust Toolset には、Cargo 1.58.1 が同梱されています。

2.1. Cargo ディレクトリー構造およびファイルの配置
リンクのコピー

Cargo ビルドツールは、セット規則を使用して Cargo パッケージ内のディレクトリー構造とファイル配置を定義します。cargo new コマンドを実行すると、マニフェストとプロジェクトファイル両方のパッケージディレクトリー構造とテンプレートが生成されます。デフォルトでは、パッケージの root ディレクトリーで新しい Git リポジトリーも初期化します。

バイナリープログラムの場合、Cargo は、Cargo.toml という名前のテキストファイルを含むディレクトリー project_name と、main.rs という名前のテキストファイルを含むサブディレクトリー src を作成します。

2.2. Rust プロジェクトの作成
リンクのコピー

Cargo の規則に従って設定される新しい Rust プロジェクトを作成します。Cargo の規則に関する詳細は、Cargo ディレクトリー構造およびファイルの配置を参照してください。

手順

以下のコマンドを実行して Rust プロジェクトを作成します。

Red Hat Enterprise Linux 7 の場合
```
scl enable rust-toolset-1.58 'cargo new --bin <project_name>'
```
```
$ scl enable rust-toolset-1.58 'cargo new --bin <project_name>'
```
Copy to Clipboard Toggle word wrap
- <project_name> をプロジェクト名に置き換えます。
Red Hat Enterprise Linux 8 の場合
```
cargo new --bin <project_name>
```
```
$ cargo new --bin <project_name>
```
Copy to Clipboard Toggle word wrap
- <project_name> をプロジェクト名に置き換えます。
Red Hat Enterprise Linux 9 の場合
```
cargo new --bin <project_name>
```
```
$ cargo new --bin <project_name>
```
Copy to Clipboard Toggle word wrap
- <project_name> をプロジェクト名に置き換えます。

注記

プロジェクトコードを編集するには、メインの実行可能ファイル main.rs を編集し、src サブディレクトリーに新しいソースファイルを追加します。

関連情報

プロジェクトの設定および依存関係の追加に関する詳細は、Rust プロジェクト依存関係の設定を参照してください。

2.3. Rust プロジェクトのライブラリーの作成
リンクのコピー

Cargo ビルドツールを使用して Rust プロジェクトのライブラリーを作成するには、以下の手順を実行します。

前提条件

既存の Rust プロジェクトがある。
Rust プロジェクトの作成方法は、Rust プロジェクトの作成を参照してください。

手順

Rust プロジェクトのライブラリーを作成するには、以下のコマンドを実行します。

Red Hat Enterprise Linux 7 の場合
```
scl enable rust-toolset-1.58 'cargo new --lib <project_name>'
```
```
$ scl enable rust-toolset-1.58 'cargo new --lib <project_name>'
```
Copy to Clipboard Toggle word wrap
- <project_name> を Rust プロジェクトの名前に置き換えます。
Red Hat Enterprise Linux 8 の場合
```
cargo new --lib <project_name>
```
```
$ cargo new --lib <project_name>
```
Copy to Clipboard Toggle word wrap
- <project_name> を Rust プロジェクトの名前に置き換えます。
Red Hat Enterprise Linux 9 の場合
```
cargo new --lib <project_name>
```
```
$ cargo new --lib <project_name>
```
Copy to Clipboard Toggle word wrap
- <project_name> を Rust プロジェクトの名前に置き換えます。

2.4. Rust プロジェクトのビルド
リンクのコピー

Cargo ビルドツールを使用して Rust プロジェクトをビルドします。Cargo は、プロジェクトのすべての依存関係を解決し、不足している依存関係をダウンロードして、rustc コンパイラーを使用してコンパイルします。

デフォルトでは、プロジェクトはデバッグモードでビルドおよびコンパイルされます。リリースモードでのプロジェクトのコンパイルに関する情報は、リリースモードでの Rust プロジェクトのビルドを参照してください。

前提条件

既存の Rust プロジェクトがある。
Rust プロジェクトの作成方法は、Rust プロジェクトの作成を参照してください。

手順

Cargo によって管理される Rust プロジェクトをビルドするには、プロジェクトディレクトリーで実行します。
- Red Hat Enterprise Linux 7 の場合
  $ scl enable rust-toolset-1.58 'cargo build'
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 8 の場合
  $ cargo build
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 9 の場合
  $ cargo build
  Copy to Clipboard Toggle word wrap
実行ファイルをビルドする必要がない場合に Rust プログラムをビルドするには、以下を実行します。

cargo check

$ cargo check

Copy to Clipboard

Toggle word wrap

2.5. リリースモードでの Rust プロジェクトのビルド
リンクのコピー

Cargo ビルドツールを使用して、リリースモードで Rust プロジェクトをビルドします。リリースモードはソースコードの最適化を行うため、コンパイルされたバイナリーの実行速度が速くなる一方で、コンパイル時間を増やすことができます。このモードを使用して、リリースと実稼働環境に適した最適化されたアーティファクトを生成します。
Cargo は、プロジェクトのすべての依存関係を解決し、不足している依存関係をダウンロードして、rustc コンパイラーを使用してコンパイルします。

デバッグモードでプロジェクトをコンパイルする方法は、Rust プロジェクトのビルドを参照してください。

前提条件

既存の Rust プロジェクトがある。
Rust プロジェクトの作成方法は、Rust プロジェクトの作成を参照してください。

手順

リリースモードでプロジェクトをビルドするには、以下を実行します。
- Red Hat Enterprise Linux 7 の場合
  $ scl enable rust-toolset-1.58 'cargo build --release'
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 8 の場合
  $ cargo build --release
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 9 の場合
  $ cargo build --release
  Copy to Clipboard Toggle word wrap
実行ファイルをビルドする必要がない場合に Rust プログラムをビルドするには、以下を実行します。

cargo check

$ cargo check

Copy to Clipboard

Toggle word wrap

2.6. Rust プログラムの実行
リンクのコピー

Cargo ビルドツールを使用して Rust プロジェクトを実行します。Cargo はまずプロジェクトを再ビルドし、作成された実行ファイルを実行します。開発中に使用される場合、cargo run コマンドはビルドモードとは独立して出力パスを正しく解決します。

前提条件

ビルド済みの Rust プロジェクトがある。
Rust プロジェクトのビルド方法は、Rust プロジェクトのビルドを参照してください。

手順

Cargo によってプロジェクトとして管理される Rust プログラムを実行するには、プロジェクトディレクトリーで実行します。

Red Hat Enterprise Linux 7 の場合
```
scl enable rust-toolset-1.58 'cargo run'
```
```
$ scl enable rust-toolset-1.58 'cargo run'
```
Copy to Clipboard Toggle word wrap
Red Hat Enterprise Linux 8 の場合
```
cargo run
```
```
$ cargo run
```
Copy to Clipboard Toggle word wrap
Red Hat Enterprise Linux 9 の場合
```
cargo run
```
```
$ cargo run
```
Copy to Clipboard Toggle word wrap

注記

プログラムがビルドされていない場合、Cargo は実行する前にプログラムをビルドします。

2.7. Rust プロジェクトのテスト
リンクのコピー

Cargo ビルドツールを使用して Rust プログラムをテストします。Cargo はまずプロジェクトを再ビルドし、次にプロジェクトにあるテストを実行します。テストできるのは、自由で単相的で引数を取らない関数のみであることに注意してください。関数の戻り値のタイプは () または Result<(), E> where E: Error のいずれかでなければなりません。

デフォルトでは、Rust プロジェクトはデバッグモードでテストされています。リリースモードでプロジェクトをテストする方法は、リリースモードでの Rust プロジェクトのテストを参照してください。

前提条件

ビルド済みの Rust プロジェクトがある。
Rust プロジェクトのビルド方法は、Rust プロジェクトのビルドを参照してください。

手順

関数の前にテスト属性 #[test] を追加します。
Cargo が管理する Rust プロジェクトのテストを実行するには、プロジェクトディレクトリーで実行します。
- Red Hat Enterprise Linux 7 の場合
  $ scl enable rust-toolset-1.58 'cargo test'
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 8 の場合
  $ cargo test
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 9 の場合
  $ cargo test
  Copy to Clipboard Toggle word wrap

2.8. リリースモードでの Rust プロジェクトのテスト
リンクのコピー

Cargo ビルドツールを使用して、リリースモードで Rust プログラムをテストします。リリースモードはソースコードの最適化を行うため、コンパイルされたバイナリーの実行速度が速くなる一方で、コンパイル時間を増やすことができます。このモードを使用して、リリースと実稼働環境に適した最適化されたアーティファクトを生成します。
Cargo はまずプロジェクトを再ビルドし、次にプロジェクトにあるテストを実行します。テストできるのは、自由で単相的で引数を取らない関数のみであることに注意してください。関数の戻り値のタイプは () または Result<(), E> where E: Error のいずれかでなければなりません。

デバッグモードでプロジェクトをテストする方法は、Testing a Rust project を参照してください。

前提条件

ビルド済みの Rust プロジェクトがある。
Rust プロジェクトのビルド方法は、Rust プロジェクトのビルドを参照してください。

手順

関数の前にテスト属性 #[test] を追加します。
Cargo が管理する Rust プロジェクトのテストをリリースモードで実行するには、プロジェクトディレクトリーで実行します。
- Red Hat Enterprise Linux 7 の場合
  $ scl enable rust-toolset-1.58 'cargo test --release'
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 8 の場合
  $ cargo test --release
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 9 の場合
  $ cargo test --release
  Copy to Clipboard Toggle word wrap

2.9. Rust プロジェクト依存関係の設定
リンクのコピー

Cargo ビルドツールを使用して Rust プロジェクトの依存関係を設定します。Cargo が管理するプロジェクトの依存関係を指定するには、プロジェクトディレクトリーの Cargo.toml ファイルを編集して、プロジェクトを再ビルドします。Cargo は、Rust コードパッケージとその依存関係のダウンロード、それらのローカルへの保存、依存関係コードパッケージを含むすべてのプロジェクトソースコードのビルド、生成される実行ファイルの実行を行います。

前提条件

ビルド済みの Rust プロジェクトがある。
Rust プロジェクトのビルド方法は、Rust プロジェクトのビルドを参照してください。

手順

プロジェクトディレクトリーで Cargo.toml ファイルを開きます。
セクションラベル [dependencies] に移動します。
各依存関係は、次の形式で新しい行に一覧表示されます。
```
crate_name = version
```
```
crate_name = version
```
Copy to Clipboard Toggle word wrap
Rust コードパッケージは crates と呼ばれます。
依存関係を編集します。
以下を実行してプロジェクトを再ビルドします。
- Red Hat Enterprise Linux 7 の場合
  $ scl enable rust-toolset-1.58 'cargo build'
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 8 の場合
  $ cargo build
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 9 の場合
  $ cargo build
  Copy to Clipboard Toggle word wrap
以下のコマンドを使用してプロジェクトを実行します。
- Red Hat Enterprise Linux 7 の場合
  $ scl enable rust-toolset-1.58 'cargo run'
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 8 の場合
  $ cargo run
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 9 の場合
  $ cargo run
  Copy to Clipboard Toggle word wrap

2.10. Rust プロジェクトのドキュメントのビルド
リンクのコピー

Cargo ツールを使用して、抽出用にマークされたソースコードのコメントからドキュメントを生成します。ドキュメントのコメントは、パブリック関数、変数、メンバーに対してのみ抽出されることに注意してください。

前提条件

ビルド済みの Rust プロジェクトがある。
Rust プロジェクトのビルド方法は、Rust プロジェクトのビルドを参照してください。
設定された依存関係がある。
依存関係の設定に関する詳細は、Rust プロジェクト依存関係の設定を参照してください。

手順

抽出用のコメントをマークするには、3 つのスラッシュ /// を使用して、ドキュメント化された行頭にコメントを配置します。
Cargo は、コメントのマークダウン言語をサポートしています。
Cargo を使用してプロジェクトのドキュメントをビルドするには、プロジェクトディレクトリーで実行します。
- Red Hat Enterprise Linux 7 の場合
  $ scl enable rust-toolset-1.58 'cargo doc --no-deps'
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 8 の場合
  $ cargo doc --no-deps
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 9 の場合
  $ cargo doc --no-deps
  Copy to Clipboard Toggle word wrap

生成されたドキュメントは .target/doc ディレクトリーにあります。

2.11. Red Hat Enterprise Linux 8 および Red Hat Enterprise Linux 9 ベータ版で Rust を使用してコードを WebAssembly バイナリーにコンパイルする
リンクのコピー

WebAssembly 標準ライブラリーをインストールするには、以下の手順を実行します。

前提条件

Rust Toolset がインストールされている。
詳細は、Rust Toolset のインストールを参照してください。

手順

WebAssembly 標準ライブラリーをインストールするには、以下を実行します。
- Red Hat Enterprise Linux 8 の場合
  # yum install rust-std-static-wasm32-unknown-unknown
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 9 の場合
  # dnf install rust-std-static-wasm32-unknown-unknown
  Copy to Clipboard Toggle word wrap
Cargo で WebAssembly を使用するには、以下を実行します。
- Red Hat Enterprise Linux 8 の場合
  # cargo <command> --target wasm32-unknown-unknown
  Copy to Clipboard Toggle word wrap
  <command> を、実行する Cargo コマンドに置き換えます。
- Red Hat Enterprise Linux 9 の場合
  # cargo <command> --target wasm32-unknown-unknown
  Copy to Clipboard Toggle word wrap
  <command> を、実行する Cargo コマンドに置き換えます。

2.12. Rust プロジェクトの依存関係のベンダー化
リンクのコピー

オフライン再分配用に、Rust プロジェクトの依存関係のローカルコピーを作成し、Cargo ビルドツールを使用して再利用します。この手順は、プロジェクトの依存関係のベンダー化と呼ばれます。Windows オペレーティングシステムでプロジェクトをビルドする Rust コードパッケージを含むベンダー化された依存関係は、vendor ディレクトリーにあります。ベンダー化された依存関係は、インターネットに接続せずに Cargo で使用できます。

前提条件

ビルド済みの Rust プロジェクトがある。
Rust プロジェクトのビルド方法は、Rust プロジェクトのビルドを参照してください。
設定された依存関係がある。
依存関係の設定に関する詳細は、Rust プロジェクト依存関係の設定を参照してください。

手順

Cargo を使用して依存関係を含む Rust プロジェクトをベンダー化するには、プロジェクトディレクトリーで以下を実行します。

Red Hat Enterprise Linux 7 の場合
```
scl enable rust-toolset-1.58 'cargo vendor'
```
```
$ scl enable rust-toolset-1.58 'cargo vendor'
```
Copy to Clipboard Toggle word wrap
Red Hat Enterprise Linux 8 の場合
```
cargo vendor
```
```
$ cargo vendor
```
Copy to Clipboard Toggle word wrap
Red Hat Enterprise Linux 9 の場合
```
cargo vendor
```
```
$ cargo vendor
```
Copy to Clipboard Toggle word wrap

2.13. 関連情報
リンクのコピー

Cargo の詳細は、Cargo の公式ガイドを参照してください。
Rust Toolset に含まれる man ページを表示するには、以下を実行します。
- Red Hat Enterprise Linux 7 の場合
  $ scl enable rust-toolset-1.58 'man cargo'
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 8 の場合
  $ man cargo
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 9 の場合
  $ man cargo
  Copy to Clipboard Toggle word wrap

第3章 rustfmt フォーマットツール
リンクのコピー

rustfmt フォーマットツールで、Rust プログラムのソースコードを自動的にフォーマットできます。rusftmt は、スタンドアロンツールまたは Cargo で使用できます。

3.1. rustfmt のインストール
リンクのコピー

rustfmt フォーマットツールをインストールするには、以下の手順を実行します。

前提条件

Rust Toolset がインストールされている。
詳細は、Rust Toolset のインストールを参照してください。

手順

以下のコマンドを実行して rustfmt をインストールします。

Red Hat Enterprise Linux 7 の場合
```
yum install rust-toolset-1.58-rustfmt
```
```
# yum install rust-toolset-1.58-rustfmt
```
Copy to Clipboard Toggle word wrap
Red Hat Enterprise Linux 8 の場合
```
yum install rustfmt
```
```
# yum install rustfmt
```
Copy to Clipboard Toggle word wrap
Red Hat Enterprise Linux 9 の場合
```
dnf install rustfmt
```
```
# dnf install rustfmt
```
Copy to Clipboard Toggle word wrap

3.2. スタンドアロンツールとしての rustfmt の使用
リンクのコピー

rustfmt をスタンドアロンツールとして使用し、Rust ソースファイルとそのすべての依存関係をフォーマットします。別の方法として、Cargo ビルドツールで rustfmt を使用します。詳細は、Cargo ビルドツールでの rustfmt の使用を参照してください。

前提条件

既存の Rust プロジェクトがある。
Rust プロジェクトの作成方法は、Rust プロジェクトの作成を参照してください。

手順

rustfmt をスタンドアロンツールとして使用して Rust ソースファイルをフォーマットするには、以下のコマンドを実行します。

Red Hat Enterprise Linux 7 の場合
```
scl enable rust-toolset-1.58 'rustfmt <source-file>'
```
```
$ scl enable rust-toolset-1.58 'rustfmt <source-file>'
```
Copy to Clipboard Toggle word wrap
- <source_file> をソースファイルの名前に置き換えます。
  <source_file> を標準入力に置き換えることもできます。次に、rustfmt は標準出力に出力を提供します。
Red Hat Enterprise Linux 8 の場合
```
rustfmt <source-file>
```
```
$ rustfmt <source-file>
```
Copy to Clipboard Toggle word wrap
- <source_file> をソースファイルの名前に置き換えます。
  <source_file> を標準入力に置き換えることもできます。次に、rustfmt は標準出力に出力を提供します。
Red Hat Enterprise Linux 9 の場合
```
rustfmt <source-file>
```
```
$ rustfmt <source-file>
```
Copy to Clipboard Toggle word wrap
- <source_file> をソースファイルの名前に置き換えます。
  <source_file> を標準入力に置き換えることもできます。次に、rustfmt は標準出力に出力を提供します。

注記

デフォルトでは、rustfmt は詳細を表示したりバックアップを作成したりせずに、影響を受けるファイルを変更します。詳細を表示してバックアップを作成するには、--write-mode value を指定して rustfmt を実行します。

3.3. Cargo ビルドツールでの rustfmt の使用
リンクのコピー

Cargo で rustfmt ツールを使用して、Rust ソースファイルとそのすべての依存関係をフォーマットします。
別の方法として、rustfmt をスタンドアロンツールとして使用します。詳細は、スタンドアロンツールとしての rustfmt の使用を参照してください。

前提条件

既存の Rust プロジェクトがある。
Rust プロジェクトの作成方法は、Rust プロジェクトの作成を参照してください。

手順

Cargo コードパッケージのすべてのソースファイルをフォーマットするには、以下のコマンドを実行します。

Red Hat Enterprise Linux 7 の場合
```
scl enable rust-toolset-1.58 'cargo fmt'
```
```
$ scl enable rust-toolset-1.58 'cargo fmt'
```
Copy to Clipboard Toggle word wrap
Red Hat Enterprise Linux 8 の場合
```
cargo fmt
```
```
$ cargo fmt
```
Copy to Clipboard Toggle word wrap
Red Hat Enterprise Linux 9 の場合
```
cargo fmt
```
```
$ cargo fmt
```
Copy to Clipboard Toggle word wrap

注記

rustfmt フォーマットオプションを変更するには、プロジェクトディレクトリーに設定ファイル rustfmt.toml を作成し、設定をファイルに追加します。

3.4. 関連情報
リンクのコピー

rustfmt のヘルプページを表示するには、以下のコマンドを実行します。
- Red Hat Enterprise Linux 7 の場合
  $ scl enable rust-toolset-1.58 'rustfmt --help'
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 8 の場合
  $ rustfmt --help
  Copy to Clipboard Toggle word wrap
- Red Hat Enterprise Linux 9 の場合
  $ rustfmt --help
  Copy to Clipboard Toggle word wrap
rustfmt ツールを設定するには、ファイル Configurations.md を編集します。
- Red Hat Enterprise Linux 7 では、以下のパスの下に見つけることができます。
  /opt/rh/rust-toolset-1.58/root/usr/share/doc/rust-toolset-1.58-rustfmt-1.58.1/Configurations.md
- Red Hat Enterprise Linux 8 では、以下のパスの下に見つけることができます。
  /usr/share/doc/rustfmt/Configurations.md
- Red Hat Enterprise Linux 9 では、以下のパスの下に見つけることができます。
  /usr/share/doc/rustfmt/Configurations.md

第4章 RHEL 8 の Rust Toolset を使用したコンテナーイメージ
リンクのコピー

RHEL 8 では、Containerfiles を使用して、独自の Rust Toolset コンテナーイメージを Red Hat Universal Base Images (UBI) コンテナー上にビルドできます。

4.1. RHEL 8 での Rust Toolset のコンテナーイメージの作成
リンクのコピー

RHEL 8 では、Rust Toolset パッケージは、Red Hat Universal Base Images (UBI) リポジトリーの一部です。コンテナーのサイズを小さく保つには、Rust Toolset 全体ではなく、個々のパッケージのみをインストールします。

前提条件

既存の Containerfile がある。
Containerfiles 作成の詳細は、Dockerfile reference ページを参照してください。

手順

Red Hat Container Catalog にアクセスします。
UBI を選択します。
Get this image をクリックして、指示に従います。
Rust Toolset を含むコンテナーを作成するには、以下の行を Containerfile に追加します。

FROM registry.access.redhat.com/ubi8/ubi:latest

RUN yum install -y rust-toolset

FROM registry.access.redhat.com/ubi8/ubi:latest

RUN yum install -y rust-toolset

Copy to Clipboard

Toggle word wrap

個々のパッケージのみを含むコンテナーイメージを作成するには、以下の行を Containerfile に追加します。

RUN yum install <package-name>

RUN yum install <package-name>

Copy to Clipboard

Toggle word wrap

<package_name> をインストールするパッケージの名前に置き換えます。

第5章 Rust 1.58.1 Toolset の変更点
リンクのコピー

Rust Toolset が、RHEL 7 および RHEL 8 のバージョン 1.54.0 から 1.58.1 に更新されました。RHEL 9 Beta には Rust Toolset 1.58.1 が同梱されています。

主な変更点は、以下のとおりです。

Rust コンパイラーは、クロージャーの disjoint キャプチャー、配列の IntoIterator、新しい Cargo 機能リゾルバーなどを備えた 2021 年版の言語をサポートするようになりました。
新しいカスタムプロファイルの Cargo サポートが追加されました。
Cargo はコンパイラーエラーを重複排除するようになりました。
新しいオープンレンジパターンが追加されました。
フォーマット文字列にキャプチャーされた識別子を追加しました。

Rust 1.58.1 Toolset の使用

1.58.1 のインストールおよび使用

多様性を受け入れるオープンソースの強化
リンクのコピー

第1章 Rust Toolset
リンクのコピー

1.1. Rust Toolset コンポーネント
リンクのコピー

1.2. Rust Toolset の互換性
リンクのコピー

1.3. Red Hat Enterprise Linux 7 での Rust Toolset へのアクセス
リンクのコピー

1.4. Rust Toolset のインストール
リンクのコピー

1.5. Rust ドキュメントのインストール
リンクのコピー

1.6. Cargo ドキュメントのインストール
リンクのコピー

第2章 Cargo ビルドツール
リンクのコピー

2.1. Cargo ディレクトリー構造およびファイルの配置
リンクのコピー

2.2. Rust プロジェクトの作成
リンクのコピー

2.3. Rust プロジェクトのライブラリーの作成
リンクのコピー

2.4. Rust プロジェクトのビルド
リンクのコピー

2.5. リリースモードでの Rust プロジェクトのビルド
リンクのコピー

2.6. Rust プログラムの実行
リンクのコピー

2.7. Rust プロジェクトのテスト
リンクのコピー

2.8. リリースモードでの Rust プロジェクトのテスト
リンクのコピー

2.9. Rust プロジェクト依存関係の設定
リンクのコピー

2.10. Rust プロジェクトのドキュメントのビルド
リンクのコピー

2.11. Red Hat Enterprise Linux 8 および Red Hat Enterprise Linux 9 ベータ版で Rust を使用してコードを WebAssembly バイナリーにコンパイルする
リンクのコピー

2.12. Rust プロジェクトの依存関係のベンダー化
リンクのコピー

第3章 rustfmt フォーマットツール
リンクのコピー

3.1. rustfmt のインストール
リンクのコピー

3.2. スタンドアロンツールとしての rustfmt の使用
リンクのコピー

3.3. Cargo ビルドツールでの rustfmt の使用
リンクのコピー

第4章 RHEL 8 の Rust Toolset を使用したコンテナーイメージ
リンクのコピー

4.1. RHEL 8 での Rust Toolset のコンテナーイメージの作成
リンクのコピー

第5章 Rust 1.58.1 Toolset の変更点
リンクのコピー

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

Rust 1.58.1 Toolset の使用

1.58.1 のインストールおよび使用

多様性を受け入れるオープンソースの強化リンクのコピーリンクがクリップボードにコピーされました!

第1章 Rust Toolsetリンクのコピーリンクがクリップボードにコピーされました!

1.1. Rust Toolset コンポーネントリンクのコピーリンクがクリップボードにコピーされました!

1.2. Rust Toolset の互換性リンクのコピーリンクがクリップボードにコピーされました!

1.3. Red Hat Enterprise Linux 7 での Rust Toolset へのアクセスリンクのコピーリンクがクリップボードにコピーされました!

1.4. Rust Toolset のインストールリンクのコピーリンクがクリップボードにコピーされました!

1.5. Rust ドキュメントのインストールリンクのコピーリンクがクリップボードにコピーされました!

1.6. Cargo ドキュメントのインストールリンクのコピーリンクがクリップボードにコピーされました!

第2章 Cargo ビルドツールリンクのコピーリンクがクリップボードにコピーされました!

2.1. Cargo ディレクトリー構造およびファイルの配置リンクのコピーリンクがクリップボードにコピーされました!

2.2. Rust プロジェクトの作成リンクのコピーリンクがクリップボードにコピーされました!

2.3. Rust プロジェクトのライブラリーの作成リンクのコピーリンクがクリップボードにコピーされました!

2.4. Rust プロジェクトのビルドリンクのコピーリンクがクリップボードにコピーされました!

2.5. リリースモードでの Rust プロジェクトのビルドリンクのコピーリンクがクリップボードにコピーされました!

2.6. Rust プログラムの実行リンクのコピーリンクがクリップボードにコピーされました!

2.7. Rust プロジェクトのテストリンクのコピーリンクがクリップボードにコピーされました!

2.8. リリースモードでの Rust プロジェクトのテストリンクのコピーリンクがクリップボードにコピーされました!

2.9. Rust プロジェクト依存関係の設定リンクのコピーリンクがクリップボードにコピーされました!

2.10. Rust プロジェクトのドキュメントのビルドリンクのコピーリンクがクリップボードにコピーされました!

2.11. Red Hat Enterprise Linux 8 および Red Hat Enterprise Linux 9 ベータ版で Rust を使用してコードを WebAssembly バイナリーにコンパイルするリンクのコピーリンクがクリップボードにコピーされました!

2.12. Rust プロジェクトの依存関係のベンダー化リンクのコピーリンクがクリップボードにコピーされました!

第3章 rustfmt フォーマットツールリンクのコピーリンクがクリップボードにコピーされました!

3.1. rustfmt のインストールリンクのコピーリンクがクリップボードにコピーされました!

3.2. スタンドアロンツールとしての rustfmt の使用リンクのコピーリンクがクリップボードにコピーされました!

3.3. Cargo ビルドツールでの rustfmt の使用リンクのコピーリンクがクリップボードにコピーされました!

第4章 RHEL 8 の Rust Toolset を使用したコンテナーイメージリンクのコピーリンクがクリップボードにコピーされました!

4.1. RHEL 8 での Rust Toolset のコンテナーイメージの作成リンクのコピーリンクがクリップボードにコピーされました!

第5章 Rust 1.58.1 Toolset の変更点リンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

多様性を受け入れるオープンソースの強化
リンクのコピー

第1章 Rust Toolset
リンクのコピー

1.1. Rust Toolset コンポーネント
リンクのコピー

1.2. Rust Toolset の互換性
リンクのコピー

1.3. Red Hat Enterprise Linux 7 での Rust Toolset へのアクセス
リンクのコピー

1.4. Rust Toolset のインストール
リンクのコピー

1.5. Rust ドキュメントのインストール
リンクのコピー

1.6. Cargo ドキュメントのインストール
リンクのコピー

第2章 Cargo ビルドツール
リンクのコピー

2.1. Cargo ディレクトリー構造およびファイルの配置
リンクのコピー

2.2. Rust プロジェクトの作成
リンクのコピー

2.3. Rust プロジェクトのライブラリーの作成
リンクのコピー

2.4. Rust プロジェクトのビルド
リンクのコピー

2.5. リリースモードでの Rust プロジェクトのビルド
リンクのコピー

2.6. Rust プログラムの実行
リンクのコピー

2.7. Rust プロジェクトのテスト
リンクのコピー

2.8. リリースモードでの Rust プロジェクトのテスト
リンクのコピー

2.9. Rust プロジェクト依存関係の設定
リンクのコピー

2.10. Rust プロジェクトのドキュメントのビルド
リンクのコピー

2.11. Red Hat Enterprise Linux 8 および Red Hat Enterprise Linux 9 ベータ版で Rust を使用してコードを WebAssembly バイナリーにコンパイルする
リンクのコピー

2.12. Rust プロジェクトの依存関係のベンダー化
リンクのコピー

第3章 rustfmt フォーマットツール
リンクのコピー

3.1. rustfmt のインストール
リンクのコピー

3.2. スタンドアロンツールとしての rustfmt の使用
リンクのコピー

3.3. Cargo ビルドツールでの rustfmt の使用
リンクのコピー

第4章 RHEL 8 の Rust Toolset を使用したコンテナーイメージ
リンクのコピー

4.1. RHEL 8 での Rust Toolset のコンテナーイメージの作成
リンクのコピー

第5章 Rust 1.58.1 Toolset の変更点
リンクのコピー