プロジェクトおよびプロジェクト・デプロイメントとGitHubリポジトリの統合
GitHubリポジトリへのアクセスは、Oracle Integrationで構成できます。 このアクセスにより、Oracle Integrationサービス・インスタンスとGitHubリポジトリの間でプロジェクトおよびプロジェクト・デプロイメントをエクスポート(プッシュ)およびインポート(プル)できます。
機能
- Oracle IntegrationからGitHubリポジトリにプロジェクトまたはプロジェクト・デプロイメント・ファイルをエクスポート(プッシュ)します。
- GitHubリポジトリからOracle Integrationにプロジェクトまたはプロジェクト・デプロイメント・ファイルをインポート(プル)します。
- 統合/プロジェクト開発管理のための継続的インテグレーション/継続的デリバリ(CI/CD)。 たとえば、プロジェクトをGitHubリポジトリにエクスポートし、自動化テストを実行して、ビジネス要件を満たしていることを確認できます。
- 統合/プロジェクトのバージョン管理。
- バックアップおよびリカバリ
- Oracle Integrationサービス・インスタンス間のプロジェクトの移動。 たとえば、あるサービス・インスタンスの開発環境から別のサービス・インスタンスの本番環境にプロジェクトを移動します。
制限事項
- GitHubリポジトリとの統合は、プロジェクトでのみ使用できます。
- サポートされているリポジトリは、GitHub (
github.com)のみです。- Enterprise GitHub (
github.com/enterprise)はサポートされていません。 - VBScript (VBS)でホストされるGitHubはサポートされていません。
- Enterprise GitHub (
前提条件
- GitHubリポジトリを作成します。 https://github.com/を参照してください。
- リポジトリにブランチを作成します。
- GitHubリポジトリのAPIキーを取得します。
- 「プロファイル」、「設定」の順に移動します。
- 設定ページの左側のメニューで、「開発者設定」に進みます。
- 「開発者設定」ページで、「個人アクセス・トークン」、「ファイングレイン・トークン」の順にクリックします。
- ファイングレイン・パーソナル・アクセス・トークン・ページで、トークンを作成します。
- ユーザーのGitHub所有者名、トークンの有効期限およびリポジトリ・アクセスを指定します。
- トークンを生成する必要があるリポジトリを選択し、リポジトリ権限でユーザーのトークンへのアクセスを提供します。
- リポジトリ権限「目次」をreadおよびwriteとして選択します。
- トークンを作成し、トークン名を指定します。
- 「GitHubリポジトリへのアクセスの構成」で使用するトークンをコピーして保存します。
GitHubリポジトリへのアクセスの構成
プロジェクトおよびプロジェクト・デプロイメントをエクスポートおよびインポートする予定のOracle Integrationサービス・インスタンスで、GitHubリポジトリへのアクセスを構成する必要があります。 ServiceAdministratorロールを持つユーザーのみが、GitHubリポジトリへのアクセスを構成できます。
- ナビゲーション・ペインで、「設定」、「リポジトリ」の順にクリックします。
- 「編集」をクリックします。
- 次の詳細を入力し、「テスト」をクリックします。
要素 説明 ユーザー名
GitHubリポジトリにアクセスするためのユーザー名を入力します。
ノート: ユーザー名としてEメール・アカウントを入力することはできません(たとえば、joesmith@mycompany.com)。 ピリオド(.)およびアットマーク(@)文字を使用すると、次のエラーが発生します。Invalid branch name. Please enter a valid branch nameリポジトリ名
GitHubリポジトリの名前を入力します。
ブランチ名
プロジェクトまたはプロジェクトのデプロイメント・ファイルをコミットするGitHubリポジトリにブランチ名を入力します。
トークンID
「前提条件」で作成した開発者トークンIDを入力します。
- 接続テストが成功した場合は、「保存」をクリックします。
GitHubリポジトリは、プロジェクトおよびプロジェクト・デプロイメントのエクスポートおよびインポート用に構成されるようになりました。 それ以外の場合は、接続エラーを修正して再度テストします。
GitHubリポジトリへのプロジェクトまたはプロジェクト・デプロイメントのエクスポート
プロジェクトまたはプロジェクト・デプロイメントは、GitHubリポジトリの構成時に指定したGitHubリポジトリ・ブランチにエクスポートします。 「プロジェクトのエクスポート」を参照してください。
GitHubリポジトリからのプロジェクトまたはプロジェクト・デプロイメントのインポート
インポートまたはプロジェクト・デプロイメントをGitHubリポジトリ・ブランチからOracle Integrationサービス・インスタンスにエクスポートします。 「プロジェクトの作成またはインポート」を参照してください。