Bitbucket-Integration

Melden Sie sich vom Terminal aus bei Ihrem Adobe Commerce on Cloud-Infrastrukturprojekt an.

magento-cloud login

Listen Sie Ihre Projekte auf und kopieren Sie die Projekt-ID.

magento-cloud project:list

Klonen Sie das Projekt in Ihrer lokalen Umgebung.

magento-cloud project:get <project-ID>

Fügen Sie Ihr Bitbucket-Repository als Remote-Datenquelle hinzu.

git remote add origin git@bitbucket.org:<user-name>/<repo-name>.git

Der Standardname für die Remoteverbindung kann origin oder magento sein. Wenn origin vorhanden ist, können Sie einen anderen Namen auswählen oder den vorhandenen Verweis umbenennen oder löschen. Siehe Git-Remote-Dokumentation.

Stellen Sie sicher, dass Sie den Bitbucket-Remote-Zugriff korrekt hinzugefügt haben.

git remote -v

Erwartete Antwort:

origin git@bitbucket.org:<user-name>/<repo-name>.git (fetch)
origin git@bitbucket.org:<user-name>/<repo-name>.git (push)

Übertragen Sie die Projektdateien in das neue Bitbucket-Repository. Denken Sie daran, alle Verzweigungsnamen gleich zu halten.

git push -u origin master

Wenn Sie mit einem neuen Bitbucket-Repository beginnen, müssen Sie möglicherweise die Option -f verwenden, da das Remote-Repository nicht mit Ihrer lokalen Kopie übereinstimmt.

Stellen Sie sicher, dass Ihr Bitbucket-Repository alle Ihre Projektdateien enthält.

Melden Sie sich bei Ihrem Bitbucket-Konto an.

Klicken Sie auf Einstellungen > Zugriffsverwaltung > OAuth.

Klicken Sie Verbraucher hinzufügen und konfigurieren Sie ihn wie folgt:

Klicken Sie Speichern.

Klicken Sie auf Verbraucher Name, um Ihre OAuth-key und -secret anzuzeigen.

Kopieren Sie Ihre OAuth-key und -secret zum Konfigurieren der Integration.

Navigieren Sie vom Terminal zu Ihrem Adobe Commerce on Cloud-Infrastrukturprojekt.

Erstellen Sie eine temporäre Datei mit dem Namen bitbucket.json und fügen Sie Folgendes hinzu. Ersetzen Sie dabei die Variablen in den spitzen Klammern durch Ihre Werte:

{
  "type": "bitbucket",
  "repository": "<bitbucket-user-name/bitbucket-repo-name>",
  "app_credentials": {
    "key": "<oauth-consumer-key>",
    "secret": "<oauth-consumer-secret>"
  },
  "prune_branches": true,
  "fetch_branches": true,
  "build_pull_requests": true,
  "resync_pull_requests": true
}

Fügen Sie die Integration mithilfe des magento-cloud CLI-Tools zu Ihrem Projekt hinzu.

magento-cloud project:curl -p '<project-ID>' /integrations -i -X POST -d "$(< bitbucket.json)"

Dadurch wird eine lange HTTP-Antwort mit Kopfzeilen zurückgegeben. Bei einer erfolgreichen Integration wird der Status-Code 200 oder 201 zurückgegeben. Ein Status von 400 oder höher zeigt an, dass ein Fehler aufgetreten ist.

Löschen Sie die temporäre bitbucket.json.

Überprüfen Sie die Projektintegration.

magento-cloud integrations -p <project-ID>

+----------+-----------+--------------------------------------------------------------------------------+
| ID       | Type      | Summary                                                                        |
+----------+-----------+--------------------------------------------------------------------------------+
| <int-id> | bitbucket | Repository: bitbucket_Account/magento-int                                      |
|          |           | Hook URL:                                                                      |
|          |           | https://magento-url.cloud/api/projects/<project-id>/integrations/<int-id>/hook |
+----------+-----------+--------------------------------------------------------------------------------+

Notieren Sie sich die Hook-URL, um einen Webhook in BitBucket zu konfigurieren.

Melden Sie sich bei Ihrem Bitbucket-Konto an.

Klicken Sie Repositorys und wählen Sie Ihr Projekt aus.

Klicken Sie Repository-Einstellungen > Workflow > Webhooks.

Überprüfen Sie den Webhook, bevor Sie fortfahren.

Wenn der Hook aktiv ist, überspringen Sie die verbleibenden Schritte und Sie die Integration. Der Hook sollte einen Namen ähnlich "Adobe Commerce on Cloud Infrastructure <project_id>" und ein Hook-URL-Format ähnlich https://<zone>.magento.cloud/api/projects/<project_id>/integrations/<id>/hook haben.

Klicken Sie Webhook hinzufügen.

Bearbeiten in der Ansicht Neuen Webhook hinzufügen“ die folgenden Felder:

• Title: Adobe Commerce-Integration
• URL: Verwenden Sie die Hook-URL aus Ihrer magento-cloud-Integrationsliste
• Trigger: Der Standardwert ist ein einfacher Repository-Push

Klicken Sie Speichern.

Erstellen Sie eine Testdatei.

touch test.md

Übertragen Sie die Änderung in das Bitbucket-Repository und übertragen Sie sie.

git add . && git commit -m "Testing Bitbucket integration" && git push

Melden Sie sich bei der Cloud Console an und stellen Sie sicher, dass Ihre Commit-Nachricht angezeigt wird und Ihr Projekt bereitgestellt wird.

Verwenden Sie die magento-cloud CLI, um die Verzweigung per Push zu übertragen.

magento-cloud environment:push from-bitbucket

Pushing from-bitbucket to the new environment from-bitbucket
Activate from-bitbucket after pushing? [Y/n] y
Parent environment [master]: integration
--- (Validation and activation messages)

Stellen Sie sicher, dass die Umgebung aktiv ist.

magento-cloud environment:list

Your environments are:
+---------------------+----------------+--------+
| ID                  | Name           | Status |
+---------------------+----------------+--------+
| master              | Master         | Active |
|  integration        | integration    | Active |
|    from-bitbucket * | from-bitbucket | Active |
+---------------------+----------------+--------+
* - Indicates the current environment

Melden Sie sich vom Terminal aus bei Ihrem Adobe Commerce on Cloud-Infrastrukturprojekt an.

Auflisten der Integrationen. Sie benötigen die Bitbucket-Integrations-ID , um den nächsten Schritt abzuschließen.

magento-cloud integration:list

Löschen Sie die Integration.

magento-cloud integration:delete <int-ID>