--- title: "Native Git | Postman API Platform" description: "コレクション、仕様、テストをYAML形式で、コードと同じGitリポジトリに保存できます。ローカルでの作業を基本とし、コードと同じ手順でリリースできます。" url: https://www.postman.com/jp/product/native-git/?utm_source=www-next-llm --- # Native Git | Postman API Platform > コレクション、仕様、テストをYAML形式で、コードと同じGitリポジトリに保存できます。ローカルでの作業を基本とし、コードと同じ手順でリリースできます。 ## Native Git コード、コレクション、仕様、テストを同じリポジトリで管理できます。ローカルでの作業を基本とし、コードと同じ手順でリリースできます。 [Postmanをダウンロード](https://www.postman.com/downloads/?utm_source=www-next-llm) [ドキュメントを読む](https://learning.postman.com/docs/use/native-git/overview?utm_source=www-next-llm) --- ## API開発に使うコレクションや仕様を、コードと同じリポジトリで管理できます。 ### コレクションと仕様をコードとともに管理できます リクエスト、仕様、環境ごとに1つのYAMLファイルを作成し、リポジトリ内の/postmanに保存します。普段レビューしているファイルと同じように、行単位で差分を確認できます。 ### 今のGitワークフローをそのまま使えます 通常のファイルなので、使い慣れたGitツールでブランチを作成し、差分の確認やレビューができます。Postmanが既存のGitツールに取って代わることはありません。 ### CIでテストし、マージ時に公開できます Postman CLIを使ってパイプライン内でコレクションを実行し、ブランチのマージ時にCloud Viewへ公開できます。 --- ## Postman AIはコレクションに加えて、コードも読み取ります コレクションがサービスのコードと同じリポジトリにファイルとして保存されるため、Postman AIは両方を読み取れます。テストで何を見落としているか尋ねると、仕様ではなく、ルートハンドラーの実装をもとに回答します。 --- *機能* ### コードベースをPostmanに合わせるのではなく、Postmanをコードベースに取り入れられます コレクション、仕様、環境を、今使っているリポジトリでコードとともにバージョン管理できます。実行には既存のパイプラインを使い、チームには自分でプッシュすると決めたタイミングで共有できます。 ### コードとAPIのコントラクト（契約）を1つのプルリクエストで変更できます ハンドラーと対応するコレクションを同じコミットで変更できます。レビュー担当者はAPIの変更とコードの変更を並べて確認でき、両方を必ず一緒にリリースできます。 ### CIでリント、テスト、公開できます Postman CLIは、ガバナンスルールに照らして仕様をリントし、違反があればビルドを失敗させます。機能テストとパフォーマンステストのスイートを実行し、マージ時に公開します。 ### チームの他のメンバーはCloud Viewで閲覧できます 準備ができたらプッシュすることで、チームの他のメンバーはPostman上で読み取り専用の内容を閲覧できます。リポジトリへのアクセスやローカルへのクローンは必要ありません。 ### どのGitプロバイダーのリポジトリでも使えます GitHub、GitLab、Bitbucketに対応し、クラウド型かセルフホスト型か、公開か非公開かを問わず、Postmanを既存のリポジトリに接続できます。 ### モノレポにも対応しています リポジトリのルートを接続し、各サービスのコレクションと環境を1つの.postman/resources.yamlにまとめて登録できます。 ### 普段の作業環境で編集できます IDEでも、Postmanでも、Agent Modeでもコレクションを編集できます。どの方法でも、編集するのはディスク上の同じYAMLファイルです。 ### Freeプランを含むすべてのプランで利用できます Native Git、無制限のワークスペース、非公開リポジトリは、有料アドオンを追加せずに利用できます。Gitを通じた共同作業に費用はかかりません。 --- ## Frequently asked questions about Postman Native Git ### What is Postman Native Git? Native Git lets you develop APIs in a local Git repository and sync them to Postman Cloud only when the work is ready to share. In Local View, your collections, environments, and specs live alongside your code. In Cloud View, they're the shared version your team can review and rely on. ### What do I need to use Native Git? Native Git works in the [Postman desktop app](/downloads/?utm_source=www-next-llm), not the web app. You also need a local project folder with your API code, and a Postman team to create the workspace in (or permission to create a workspace outside a team). ### Is Native Git available on the Free plan? Yes. Native Git is available on every Postman plan, including Free. Compare plans on the [Postman pricing page](/pricing/?utm_source=www-next-llm). ### Which Git providers does Native Git support? Native Git works with GitHub, GitLab, and Bitbucket, cloud or self-hosted, with public or private repositories. ### Where does Native Git store files in my repository? Native Git writes one YAML file per request, spec, and environment under the postman directory, and registers them in a .postman/resources.yaml manifest. In a monorepo, connect the repository root and register every service's resources in that one manifest. ### Does Postman replace my Git client? No. You branch, diff, review, and commit with Git in your own terminal, IDE, or Git host. Postman doesn't do those steps for you. When the work is ready to share, you sync it to Postman Cloud. ### How do I automate Native Git in CI/CD? Use the [Postman CLI](/product/postman-cli/?utm_source=www-next-llm). Run postman workspace lint on pull requests, and postman workspace push to sync local files to the cloud workspace after merge. Authenticate the pipeline with a Postman API key stored as a secret; pushes from CI are attributed to the account that owns the key. The [Native Git CI/CD guide](https://learning.postman.com/docs/use/native-git/automation/?utm_source=www-next-llm) has the full setup. ### Can Newman run Native Git collections? No. Native Git uses the v3 YAML collection format, and Newman only supports the v2.1 JSON format. Run Native Git collections with the Postman CLI, and use postman collection migrate to convert older collections to v3. --- *リソース* ## Native Gitをさらに詳しく知る ### Native Gitのドキュメント Local View、Git、Cloud Viewの連携の仕組みと、Native Gitがリポジトリに保存する内容を説明します。 [ドキュメントを読む](https://learning.postman.com/docs/use/native-git/overview?utm_source=www-next-llm) ### Native Gitを設定 ワークスペースをリポジトリに接続する方法を説明します。リソースマニフェストやモノレポの構成についても解説します。 [ガイドを読む](https://learning.postman.com/docs/use/native-git/setup?utm_source=www-next-llm) ### Native Gitでローカル開発 ローカルのYAMLファイルを編集し、ローカルで動作するサービスに対してコレクションを実行できます。プッシュするまで、変更はクラウドに反映されません。 [ガイドを読む](https://learning.postman.com/docs/use/native-git/develop-locally?utm_source=www-next-llm) --- ## お使いのリポジトリでNative Gitを活用する方法をご紹介します。 Native Gitは、リポジトリの接続、コレクションや仕様と対象コードのバージョン管理、既存のパイプラインでの実行を支援します。こちらのフォームより、お気軽にご相談ください。