Die Integration von Asana für GitHub ist auf den Ebenen Asana Starter, Advanced, Enterprise und Enterprise+ sowie auf den bisherigen Stufen Premium, Business und Legacy Enterprise verfügbar.
Besuchen Sie unsere Preisübersichts-Seite, um weitere Informationen zu erhalten.
Mit der Asana-GitHub-Integration verbessern sie die funktionsübergreifende Zusammenarbeit, indem Sie automatisch Pull Requests und Status-Updates von GitHub mit Aufgaben in Asana synchronisieren.
Diese Integration trägt dazu bei, die Sichtbarkeit und Transparenz bei Entwicklungsprojekten zwischen technischen und nicht-technischen Teams zu erhöhen. Mit dieser neuen Integration können Entwickler mühelos in Asana kommunizieren, um Teams und Beteiligte aus anderen Abteilungen auf dem Laufenden zu halten und zu verhindern, dass die Arbeit durch die Ritzen fällt.
Diese Integration unterstützt GitHub Enterprise Server nicht.
Installation für Asana und GitHub Actions
Verknüpfen Sie Asana und GitHub, um den Status Ihrer Pull Requests zu synchronisieren. Um die Integration zu nutzen, wird die Konfiguration in Asana eingerichtet - für zusätzliche Features in GitHub.
So funktioniert die Konfiguration in Asana:
- Navigieren Sie zu einem Asana Projekt, in dem Sie die Integration Asana für GitHub installieren möchten. Klicken Sie oben rechts auf die Schaltfläche Anpassen.
- Scrollen Sie nach unten zu Apps und wählen Sie + App hinzufügen
- GitHub auswählen
Herzlichen Glückwunsch! Sie können nun Pull Requests von GitHub mit Asana-Aufgaben verknüpfen. Wenn Sie dieser Integration noch weitere Funktionen hinzufügen möchten, lesen Sie den nächsten Abschnitt. Andernfalls können Sie diesen Abschnitt überspringen.
So konfigurieren Sie GitHub Actions:
Dieser Abschnitt setzt Grundkenntnisse über Git und Repository Secrets in Git und GitHub voraus. Falls Sie über keinen Zugang verfügen, um Repository Secrets einzurichten, kontaktieren Sie bitte den entsprechenden Verantwortlichen.
Wir unterstützen zwei Arten von GitHub Actions:
- Automatische Benachrichtigungen über GitHub Pull Requests in Asana: Diese Aktion kommentiert den Status des Pull Request in der Aufgabe in Asana. Sie beinhaltet den Titel des Pull Request mit einem Link zur verknüpften Asana-Aufgabe. Um diese Aktion einzurichten, besuchen Sie die Seite GitHub Actions.
- Verknüpfung von Anhängen aus Beschreibungen von GitHub Pull Requests mit Asana: Diese Aktion verknüpft automatisch GitHub Pull Requests mit einer oder mehreren Aufgaben in Asana, indem der/die Aufgabenlink/s von Asana der Beschreibung des Pull Request hinzugefügt wird/werden. Um diese Aktion einzurichten, besuchen Sie die Seite GitHub Actions.
So wie andere GitHub-Aktionen werden auch diese nur dann ausgeführt, wenn im Repository ein Ereignis eintritt, für das Sie die Aktionen eingerichtet haben. Sie können zum Beispiel eine Aktion einrichten, die jedes Mal ausgeführt wird, wenn es zu einem Merge oder Kommentaren in den entsprechenden Pull Requests kommt.
Jede dieser GitHub-Aktionen muss separat eingerichtet werden, es sei denn, es handelt sich um mehrere identische Aktionen im selben Repository. So können Sie beispielsweise eine Aktion einrichten, mit der sich die Aufgabe in der Beschreibung des Pull Requests kommentieren lässt, wenn eine Prüfung abgeschlossen wurde, und eine andere Aktion, die der Aufgabe einen anderen Kommentar hinzufügt, wenn der Merge des Pull Requests stattgefunden hat.
GitHub-Aktionen können auch als Teil eines bereits existierenden Workflows hinzugefügt werden. Referenz auf den Leitfaden von GitHub Actions, um mehr zu erfahren.
Geheime Tokens widerrufen
Wenn Sie GitHub-Aktionen im vorangegangenen Abschnitt eingerichtet haben, können Sie geheime Tokens auch widerrufen. Besuchen Sie diese Einrichtungsseite und wählen Sie Alle widerrufen.
Dadurch werden alle existierenden geheimen Token der GitHub-Aktionen widerrufen.
Sie können immer noch die Informationen zu den Pull Requests in den existierenden Asana Projekten sehen, in denen Sie diese Integration hinzugefügt haben.
Funktionsweise der Integration
So fügen Sie einer Asana-Aufgabe einen Pull Request hinzu (in Asana):
Nachdem Sie die GitHub-Integration in Asana installiert haben, können Sie in jeder Aufgabe des entsprechenden Projekts ein GitHub-Feld sehen.
Um einer Asana-Aufgabe einen Pull Request hinzuzufügen, rufen Sie die URL des Pull Requests ab und fügen Sie sie in das leere GitHub-Feld ein. In der Asana-Aufgabe sollte nun ein Widget mit folgenden Informationen erscheinen: Review-Status, Build-Status, PR-Status, Zeilenänderungen und Anzahl der Kommentare in GitHub.
So fügen Sie einer Asana-Aufgabe einen Pull Request hinzu (in GitHub):
Nachdem Sie die GitHub-Integration in Asana installiert und GitHub Actions eingerichtet haben, können Sie nun automatisch einer Asana-Aufgabe einen Pull Request über die Beschreibung eines GitHub Pull Request hinzufügen.
Rufen Sie die URL der Asana-Aufgabe auf und fügen Sie sie in der Beschreibung des GitHub Pull Request ein. Wenn Sie sich danach die Aufgabe in Asana ansehen, sollte ein Widget mit folgenden Informationen erscheinen: Review-Status, Build-Status, PR-Status und Zeilenänderungen.
Sämtliche Fehler sollten im Tab „GitHub Actions“ in GitHub zu sehen sein.
So erhalten Sie Merge- und Close-Benachrichtigungen zu Pull Requests:
Pull Requests können in GitHub geschlossen werden, nachdem die entsprechenden Teams die Änderungen überprüft und zusammengeführt haben. Der Status im Asana-Widget wird automatisch aktualisiert.
Wenn Sie eine neue GitHub-Pull-Anfrage anhängen möchten, können Sie die URL der Aufgabe in Asana zur neuen Beschreibung der GitHub-Pull-Anfrage hinzufügen und das Widget wird automatisch ersetzt, oder Sie können die geschlossene Pull-Anfrage in Asana entfernen, indem Sie auf das Menü oben rechts klicken. Nach dem Entfernen können Sie eine neue URL für die GitHub-Abrufanforderung eingeben.
Nachdem Sie die GitHub-Integration in Asana installiert und GitHub Actions eingerichtet haben, erhalten Sie Kommentare in Asana-Aufgaben mit einem offenen Pull Request im Anhang. Sie enthalten Informationen darüber, ob der Pull Request zusammengeführt bzw. geschlossen wurde oder nicht.
FAQ
Kann dasselbe generierte Secret in mehreren Repositorys verwendet werden?
Ja
Können meine Teamkollegen Informationen zu Pull Requests sehen, die ich einer Asana-Aufgabe hinzufüge, selbst wenn sie keinen Zugriff auf den Pull Request haben?
Ja. Wenn Sie einer Aufgabe einen Pull Request hinzufügen, kann jeder, der die Aufgabe sehen kann, auch das Widget sehen.
Wird mein alter Secret Token deaktiviert, wenn ich einen neuen Token generiere?
Nein, Ihre alten Secret Tokens funktionieren dann immer noch. Wenn Sie Ihre bestehenden Secret Tokens deaktivieren möchten, können Sie das hier tun.
Kann dasselbe generierte Secret in mehreren Repositorys verwendet werden?
Ja
Wenn ich versuche, die Workflow-Datei zu verschieben, sagt mir git, dass mein Token keine Berechtigung hat, Workflows zu erstellen. Was kann ich tun?
Wenn Sie die Zwei-Faktor-Authentifizierung verwenden und mit GitHub über die Kommandozeile interagieren, verlangt GitHub, dass Sie den Token für Ihren persönlichen Zugang als Passwort verwenden. Bitte erstellen Sie einen neuen Token für den persönlichen Zugang zu GitHub, der den Workflow beinhaltet.
Warum sind diese Genehmigungen in GitHub notwendig?
Wir lesen und schreiben lediglich im Rahmen von Pull Requests dieser Integration. Die Genehmigung auf der Authentifizierungsseite ist die restriktivste, die GitHub uns erlaubt abzufragen, um auf Pull Requests zuzugreifen.
Was passiert, wenn die GitHub-Aktion einen Pull Request einer Aufgabe in einem Projekt hinzufügt, in dem die Integration nicht aktiviert ist?
Im Kommentarbereich der Aufgabe wird ein Link zum Pull Request angezeigt, aber das Widget, das den Status des Pull Requests enthält, erscheint nicht.
Gefällt Ihnen, was Sie sehen? Probieren Sie Asana noch heute aus - 30 Tage lang kostenlos