トレーニング
モジュール
プライベート レジストリを使用して Bicep モジュールを共有します - Training
Bicep レジストリを使用して、再利用可能な Bicep モジュールを操作します。 組織のプライベート レジストリを作成します。 組織のレジストリを使用して、モジュールを発行および使用します。
このブラウザーはサポートされなくなりました。
Microsoft Edge にアップグレードすると、最新の機能、セキュリティ更新プログラム、およびテクニカル サポートを利用できます。
vcpkg は、パッケージのリポジトリを管理するためにレジストリと呼ばれる概念を使用します。 既定では、vcpkg は、 https://github.com/Microsoft/vcpkgのパブリックキュレーション レジストリからライブラリを検索します。 サード パーティまたはプライベート レジストリを追加して、追加のパッケージをインストールできるようにします。
独自のレジストリの作成については、パッケージをレジストリに 発行するチュートリアルを参照してください。
レジストリは、 vcpkg-configuration.json
ファイルを使用して構成されます。
このチュートリアルでは、次の事項について説明します。
新しいフォルダーに、次のプロジェクト ファイルを作成します。
ソース ファイル (main.cpp
):
#include <iostream>
#include <beison.h>
int main()
{
beison::Object obj;
obj.insert("name", beison::Value::string("demo"));
std::cout << beison::stringify(obj) << std::endl;
return 0;
}
CMake プロジェクト ファイル (CMakeLists.txt
):
cmake_minimum_required(VERSION 3.18)
project(demo CXX)
add_executable(main main.cpp)
find_package(beicode CONFIG REQUIRED)
find_package(beison CONFIG REQUIRED)
target_link_libraries(main PRIVATE beicode::beicode beison::beison)
次のコマンドを実行します。
vcpkg new --application
new
コマンドは、マニフェスト (vcpkg.json
) ファイルと構成 (vcpkg-configuration.json
) ファイルの 2 つのファイルを作成します。 通常、このコマンドでは --name
引数と --version
引数を指定する必要がありますが、このチュートリアルはエンドユーザー アプリケーションであるため、代わりに --application
オプションを使用します。
生成されたファイルの内容は次のとおりです。
vcpkg.json
{}
vcpkg-configuration.json
{
"default-registry": {
"kind": "git",
"baseline": "7476f0d4e77d3333fbb249657df8251c28c4faae",
"repository": "https://github.com/microsoft/vcpkg"
},
"registries": [
{
"kind": "artifact",
"location": "https://github.com/microsoft/vcpkg-ce-catalog/archive/refs/heads/main.zip",
"name": "microsoft"
}
]
}
生成された構成ファイルには、2 つのレジストリ定義が含まれています。 https://github.com/Microsoft/vcpkgでキュレーションされた vcpkg レジストリを指すdefault-registry
。最新のコミットを基準として使用し追加の"artifacts"
レジストリを使用します。このチュートリアルの目的は不要であり、削除できます。
ソース コードは、vcpkg キュレーション レジストリで使用できない 2 つのライブラリを参照します。 これらの依存関係を満たすためには、 https://github.com/microsoft/vcpkg-docs を追加のレジストリとして追加する必要があります。
vcpkg-configuration.json
の内容を次の内容に変更します。
{
"default-registry": {
"kind": "git",
"baseline": "7476f0d4e77d3333fbb249657df8251c28c4faae",
"repository": "https://github.com/microsoft/vcpkg"
},
"registries": [
{
"kind": "git",
"repository": "https://github.com/microsoft/vcpkg-docs",
"reference": "vcpkg-registry",
"baseline": "768f6a3ad9f9b6c4c2ff390137690cf26e3c3453",
"packages": [ "beicode", "beison" ]
}
]
}
構成ファイルは、 beicode
および beison
パッケージのソースとして外部レジストリを追加します。 追加のレジストリでは、 "packages"
リストを使用して、提供するパッケージを明示的に宣言する必要があります。 vcpkg がパッケージ名をレジストリに解決すると、追加のレジストリに見つからないパッケージ名は既定で "default-registry"
に設定されます。 パッケージの名前解決の詳細についてはレジストリのドキュメントを参照してください。
構成ファイルにレジストリが追加されたら、そこからパッケージをインストールするために特別な作業を行う必要はありません。vcpkg は、通常のインストール機構に従うと、 vcpkg.json
内のパッケージ名を正しいレジストリに透過的に解決します。
vcpkg.json
ファイルにbeicode
とbeison
の依存関係を追加します。
vcpkg add port beicode beison
プロジェクトをビルドして実行します ( $VCPKG_ROOT
を vcpkg のインストール パスに置き換えます)。
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake
cmake --build build
プログラムを実行すると、出力は次のようになります。
{
"name": "demo"
}
vcpkg に関するフィードバック
vcpkg はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。
トレーニング
モジュール
プライベート レジストリを使用して Bicep モジュールを共有します - Training
Bicep レジストリを使用して、再利用可能な Bicep モジュールを操作します。 組織のプライベート レジストリを作成します。 組織のレジストリを使用して、モジュールを発行および使用します。