2021年10月の.NETラボの発表で使用した資料です。 発表中に使用したCode/CI/Artifacts は下記になります https://dev.azure.com/devtakas-public/dotnetlab-2021-oct

1. Azure Artifactsを触ってみよう
2021.10 .NETラボ

2. 誰？
Takas(@DevTakas)
Angular / Azure / .NET Core / Azure DevOps / Microsoft Graph
Microsoft MVP Office Development

3. 誰？
ブログやってます
http://takasdev.hatenablog.com/
「はまったりひらめいたり…とか…」

4. ほんじつのまとめ

5. Azure Artifactsはいいぞ！

6. Azure Artifactsを使いたいモチベーション
独自パッケージを手軽に管理したい

7. .NETのパッケージを
ローカルで展開するときのおもいで…
🤔
・ファイルサーバーにおいてVSでレジストリ指定するか…？
・NuGetサーバーたてる？面倒くさい…
・変更の管理とかも自前でJenkinsおじさんになるのか…？
・そもそも管理面倒だな

8. Azure Artifactsを使うのがおすすめな状況
• Azure DevOpsを使っている
• 社内でパッケージ開発をしている
• パッケージを使用した開発が至るところで行われている
• Publicにパッケージは公開したくない
• アクセス管理はAADベースで行いたい

9. Azure Artifactsができること
• パッケージの公開
• 公開パッケージを容易に使用することができる
• アクセス管理
• CIによるパッケージのバージョン管理
• 部門など(Azure DevOpsの組織)を跨いだコラボレーションが容易

10. おしながき
1. Azure Artifactsとは
2. Azure Artifactsを触ってみよう
3. Azure Artifactsのアクセス管理
4. Azure Artifactsのバージョン管理
5. Upstream Sourceを使う
6. まとめ

11. 1. Azure Artifactsとは

12. 1. Azure Artifactsとは
-公式ページの紹介から抜粋
• パッケージフィードサービス
• 独自のパッケージなどを閉じた環境で配信することができる
• 対応しているものは上記の通り
• npmやnugetコマンドなど一般的なパッケージを使用するときと同じ感覚で
プライベートなパッケージを使用可能になる
• 類似サービス
• GitHub Packages
• npm private registry
• verdaccio(OSS)
> パブリックおよびプライベートのソースから、Maven、npm、NuGet、Python パッケージの
フィードを作成して共有

13. 1. Azure Artifactsとは
-💲
• Azure DevOps Service
• ～2GB：無料
• 2GB以降224/GB
• 自動で課金ではなくアップロードできなくなる安心設計

14. 1. Azure Artifactsとは
-💲
• 課金はOrganizationの設定のBillingから設定

15. 1. Azure Artifactsとは
• npmやNuGetの標準コマンドでアクセス可能
• 一般的なパッケージ等と同じ感覚で使用することができる
• 閉じた中で使用したいパッケージであっても
• AADによるアクセス制御が行えるのでAADユーザーなら色々楽
• azコマンドを拡張してアクセスすることも可能
• あんまり使わないけどUniversal Packageで使用する場合に
• 他OrganizationのArtifactsとの連携も楽(後述)

16. 2. Azure Artifactsを使ってみよう

17. 2. Azure Artifactsを使ってみよう
-どこにあるのか

18. 2. Azure Artifactsを使ってみよう
-ない場合はここで設定をおこなう

19. Feed
Package
2. Azure Artifactsを使ってみよう
-Artifactsの構成

20. ユーザーは各レジストリからパッケージを取得する
管理はFeed単位
Feed
NuGet
npm
Maven
…
2. Azure Artifactsを使ってみよう
-Azure Artifactsの構成

21. • Feedがパッケージを提供するレジストリを持っている
• npmやNuGetのパッケージはFeedに格納され
Feedから提供される
• 別のアドレスや名前空間で提供したい場合は
Create Feedで新しい名前のFeedを作成する
• 組織に紐付けるかプロジェクトに紐付けるか選択できる
2. Azure Artifactsを使ってみよう
-どこにあるのか

22. • 認証で保護された領域へのアクセスは認証を通す必要あり
• ‘Connect to feed’から確認可能
• npmの場合(Windowsの場合)
• vsts-npm-authをGlobalにインストールして
.npmrcを作成してコマンド実行
• NuGetの場合
• nuget.configを作成する
2. Azure Artifactsを使ってみよう
-ローカルの開発環境からアクセスする

23. • vsts-npm-authを使用しない場合
1. PAT(Personal Access Token)を作成する
2. Userディレクトリの.npmrcに設定を行う
• //pkgs.dev.azure.com/{org}/{project}/_packaging/{feed}/npm/registry/:_auth
token={PAT}
• vsts-npm-authの認証トラブル時も
ここを削除して再認証すると成功することもある
2. Azure Artifactsを使ってみよう
-ローカルの開発環境からアクセスする

24. • Upstream Sourceを切っておくほうが良い
• npmやnugetのパブリックリポジトリからリソースを収集してくる
• 大型パッケージなんか参照すると容量結構食うので…
2. Azure Artifactsを使ってみよう
-おすすめの設定

25. • Upstream Source潰しに伴って下記の対応を行う
• npmの場合は@hogehoge/xxxxな名前でパッケージを管理して
スコープを含めるようにしたほうが良い
• NuGetはnuget.configにAritifactsのフィードURLだけでなく
公式のパブリックリポジトリも含めるのが良い
• 使用量はOrganization Settingから確認可能
2. Azure Artifactsを使ってみよう
-おすすめの設定

26. • Azure ArtifactsのFeedを作成してみる
• vsts-npm-authを使用してみる
• Azure Artifactsで管理されているnpm/NuGetを取得してみる
2. Azure Artifactsを使ってみよう
-Demo

27. 3.Azure Artifactsのアクセス管理

28. • Permissionからアクセス可能ユーザーの設定を行う
3.Azure Artifactsのアクセス管理
-アクセスできるユーザーの設定

29. 3.Azure Artifactsのアクセス管理
-アクセスできるユーザーの設定内容

30. • ユーザーやグループ追加時
• CIの設定時
• CIでパッケージを利用する際にFeedにアクセスする
CI内部で使用されるユーザーをPermissionで追加する必要がある
3.Azure Artifactsのアクセス管理
-どんなときにPermissionを追加するのか

31. 4. Azure Artifactsのバージョン管理

32. • ローカルで一々バージョン上げてPublishするのは超面倒
• CIビルドしているのだからそのときに一緒に上げてしまいたい
4. Azure Artifactsのバージョン管理
-CIで自動でバージョンを管理したい

33. • 同一バージョンでPublishすると403が返却されるので
バージョンアップを行う作業が必要となる
• CIからFeedにアクセスするにはアクセス許可が必要
• CI内でのインストールでしたときと同じような権限設定が必要
• CIを実行しているユーザーにアップできる権限を与える
• サフィックスをつけるなどしてプレリリース運用もしたい
4. Azure Artifactsのバージョン管理
-CIで自動でバージョンを管理したい(共通編)

34. 4. Azure Artifactsのバージョン管理
-CIで自動でバージョンを管理したい(共通編)

35. • バージョンアップはnpmコマンドで行う
• npm version prerelease … ：プレリリースコマンド
• npm version patch … : パッチリリースコマンド
• マイナー/メジャーリリースは任意タイミングが良いと思う
• バージョンはソース内のpackage.jsonで管理される
• =バージョンを上げたら変更をコミットしたい
• CIでコミット/プッシュできる権限を与えて上げれば良い
4. Azure Artifactsのバージョン管理
-CIで自動でバージョンを管理したい(npm編)

36. 4. Azure Artifactsのバージョン管理
-CIで自動でバージョンを管理したい(共通編)
ポリシーで保護されたブランチに
コミットする場合に使用

37. • マイナーの*を使っても良いが日付ベースなので好みが別れる
• 1ずつインクリメントしたいとか
• msbuild.exeを利用したCIを実行する
• VersionPrefix/Suffixを利用してバージョン番号を指定する
• PowerShellで算出したり、外部WebAPIを利用したり
• npmと比べると面倒くさいので外部のWebAPI使うほうが楽な印象
4. Azure Artifactsのバージョン管理
-CIで自動でバージョンを管理したい(.NET編)

38. • CI の権限設定
• ArtifactsのPermission設定
• npmのビルド
• NuGetのビルド
4. Azure Artifactsのバージョン管理
-Demo

39. 5. Upstream Sourceを使う

40. • Upstream SourceはPublicレジストリ参照以外に何に使うのか
• 他OrganizationのArtifactsの参照を行うときに使用する
• 特にCIの用途で重要な要素となる
• 他Organizationには当然、CI実行Build Serviceはいない
• =他OrganizationのArtifactsにアクセスできない
• そこでUpstream Sourceを使って自分のOrgのFeedから参照する
5. Upstream Sourceを使う
-他OrganizationのArtifactsとの接続
他Org Feed
自Org Feed
Upstream Sourceで
パッケージ取得
Build Service
ライブラリ参照

41. 5. Upstream Sourceを使う
-Demo

42. 6.まとめ

43. Azure Artifactsはいいぞ！

44. Azure Artifactsができること
• パッケージの公開
• 公開パッケージを容易に使用することができる
• アクセス管理
• CIによるパッケージのバージョン管理
• 部門など(Azure DevOpsの組織)を跨いだコラボレーションが容易

45. 参考ページ
• Azure Artifacts
• https://azure.microsoft.com/ja-jp/services/devops/artifacts/
• 権限の構成
• https://docs.microsoft.com/ja-jp/azure/devops/artifacts/feeds/feed-permissions?view=azure-devops
• YAML スキーマ リファレンス
• https://docs.microsoft.com/ja-jp/azure/devops/pipelines/yaml-schema?view=azure-
devops&tabs=schema%2Cparameter-schema
• アップストリーム ソース
• https://docs.microsoft.com/ja-jp/azure/devops/artifacts/concepts/upstream-sources?view=azure-devops