関数のブランチ化

グローバルブランチで関数を開発、公開、利用できます。現在、TypeScript v1、TypeScript v2、Python、および AIP Logic の関数がサポートされています。

関数を開発する

グローバルブランチで関数を開発する前に、リポジトリが次の要件を満たしていることを確認してください。

• TypeScript v1 で Global Branching を使用するには、functions-typescript 子テンプレートをバージョン 0.903.0 以降にアップグレードします。
• TypeScript v2 で Global Branching を使用するには、typescript-functions 親テンプレートをバージョン 0.1299.0 以降にアップグレードし、ローカルオントロジー SDK を有効にします。
• Python で Global Branching を使用するには、python-functions 親テンプレートをバージョン 0.724.0 以降にアップグレードし、ローカルオントロジー SDK を有効にします。

手順については、リポジトリのアップグレードに関するドキュメントを参照してください。

グローバルブランチ上で新しく作成または変更されたオントロジーリソースなど、リソースへの変更に依存する関数を開発できます。

準備ができたら、対象バージョンを指定して関数を公開します。これは、グローバルブランチのマージ時に main に公開される安定バージョンです。このブランチでの開発中は、関数は不安定なプレビューバージョンとして公開されます。

ブランチで関数が正常に公開されると、このブランチの新しい関数バージョンを Workshop、AIP Logic、および関数ベースのアクションで使用できます。この関数バージョンには、ブランチのプレリリースタグが付けられます。このブランチで公開された関数には、main を含むほかのブランチからはアクセスできません。

このブランチで開発を続ける間、同じ対象バージョンに対して関数バージョンを継続して公開できます。対象バージョンが変わらない限り、関数を使用するリソースは、公開済みの最新バージョンを自動的に取得します。これにより、公開するたびに関数の参照を手動で更新することなく、すばやく反復開発できます。

ブランチの対象バージョンが変更された場合は、ブランチで古いバージョンを使用していた、関数に依存するすべてのリソースを更新し、新しい対象バージョンを使用するようにする必要があります。これは、チェックとしても表示されます。

競合を解決する・関数をリベースする

ブランチで開発している間、main に公開されたより新しい関数バージョンは自動的には取り込まれません。これにより、メインブランチでの開発がこのブランチでの作業を妨げることを防ぎます。main により新しいバージョンがある場合は、関数バージョンの選択画面と Ontology Manager に通知が表示されます。その後、関数バージョンをリベースして、main からより新しいバージョンをすべて取り込むことができます。

開発中に対象バージョンが main に公開された場合は、マージする前に新しい対象バージョンを選択する必要があります。選択したら、依存するリソースを更新して、新しい対象バージョンを使用するようにします。

マージする

グローバルブランチをマージすると、変更された関数が安定版の対象バージョンとして main に公開されます。このブランチで公開されたバージョンを使用しているリソースは、マージの一環として main に公開された新しい安定バージョンを自動的に使用し始めます。