AWS CodeStar-Projektvorlagen

AWS CodeStarMit Projektvorlagen können Sie mit einer Beispielanwendung beginnen und diese mithilfe von AWS Ressourcen bereitstellen, die zur Unterstützung Ihres Entwicklungsprojekts erstellt wurden. Wenn Sie eine AWS CodeStar Projektvorlage auswählen, werden der Anwendungstyp, die Programmiersprache und die Rechenplattform für Sie bereitgestellt. Nachdem Sie Projekte mit Webanwendungen, Webservices, Alexa-Kenntnissen und statischen Webseiten erstellt haben, können Sie die Beispielanwendung durch Ihre eigene ersetzen.

Nachdem Sie Ihr Projekt AWS CodeStar erstellt haben, können Sie die AWS Ressourcen ändern, die die Bereitstellung Ihrer Anwendung unterstützen. AWS CodeStarfunktioniert mitAWS CloudFormation, damit Sie mithilfe von Code Supportdienste und Server/serverlose Plattformen in der Cloud erstellen können. AWS CloudFormationermöglicht es Ihnen, Ihre gesamte Infrastruktur in einer Textdatei zu modellieren.

AWS CodeStar Projektdateien und Ressourcen

Ein AWS CodeStar Projekt ist eine Kombination aus Quellcode und erstellten Ressourcen, um den Code bereitzustellen. Die Sammlung von Ressourcen, die Ihnen bei der Erstellung, Freigabe und Bereitstellung Ihres Codes helfen, heißt Toolchain-Ressourcen. Bei der Projekterstellung stellt eine AWS CloudFormation-Vorlage Ihre Toolchain-Ressourcen in einer CI/CD-Pipeline (Continuous Integration/Continuous Deployment) bereit.

Sie können AWS CodeStar damit Projekte auf zwei Arten erstellen, je nachdem, wie viel Erfahrung Sie mit der Erstellung von AWS Ressourcen haben:

• Wenn Sie die Konsole zum Erstellen eines Projekts verwenden, erstellt AWS CodeStar Ihre Toolchain-Ressourcen, einschließlich Ihres Repositorys, und füllt Ihr Repository mit Anwendungsbeispiel-Code und Projektdateien. Verwenden Sie die Konsole, um schnell Beispielprojekte basierend auf einer Reihe von vorkonfigurierten Projektoptionen einzurichten.

• Wenn Sie die CLI zum Erstellen eines Projekts verwenden, stellen Sie die AWS CloudFormation-Vorlage zur Verfügung, die Ihre Toolchain-Ressourcen erstellt, sowie auch den Anwendungsquellcode. Verwenden Sie die CLI, um AWS CodeStar zu erlauben, Ihr Projekt aus Ihrer Vorlage zu erstellen und dann Ihr Repository mit Ihrem Beispielcode zu füllen.

Ein AWS CodeStar Projekt bietet eine einheitliche und zentrale Verwaltung. Sie können den Assistenten Create project in der Konsole verwenden, um ein Beispielprojekt einzurichten. Sie können es dann als Kollaborationsplattform für die Verwaltung von Berechtigungen und Ressourcen für Ihr Team verwenden. Weitere Informationen finden Sie unter Was ist AWS CodeStar?. Wenn Sie die Konsole zum Erstellen eines Projekts verwenden, wird Ihr Quellcode als Beispielcode bereitgestellt, und Ihre CI/CD-Toolchain-Ressourcen werden für Sie erstellt.

Wenn Sie ein Projekt in der Konsole erstellen, stellt AWS CodeStar die folgenden Ressourcen zur Verfügung:

• Ein Code-Repository in GitHub oder CodeCommit.

• Im Projekt-Repository eine Datei README.md, die Details zu Dateien und Verzeichnissen enthält.

• Im Projekt-Repository befindet sich eine Datei template.yml, die die Definition für den Laufzeit-Stack Ihrer Anwendung speichert. Sie verwenden diese Datei, um Projektressourcen hinzuzufügen oder zu ändern, bei denen es sich nicht um Toolchainressourcen handelt, z. B. AWS Ressourcen, die für Benachrichtigungen, Datenbankunterstützung, Überwachung und Ablaufverfolgung verwendet werden.

• AWSServices und Ressourcen, die in Verbindung mit Ihrer Pipeline erstellt wurden, z. B. der Amazon S3 S3-Artifact-Bucket, Amazon CloudWatch Events und verwandte Servicerollen.

• Eine funktionierende Beispielanwendung mit vollständigem Quellcode und einem öffentlichen HTTP-Endpunkt.

• Eine AWS Rechenressource, die auf dem AWS CodeStar Projektvorlagentyp basiert:

  • Eine Lambda-Funktion.

  • Eine Amazon-EC2-Instance.

  • Eine AWS Elastic Beanstalk-Umgebung.

• Ab dem 6. Dezember 2018 PDT:

  • Eine Berechtigungsgrenze, die eine spezielle IAM-Richtlinie zur Kontrolle des Zugriffs auf Projektressourcen ist. Die Berechtigungsgrenze ist standardmäßig Rollen im Beispielprojekt angefügt. Weitere Informationen finden Sie unter IAM-Berechtigungsgrenze für Auftragnehmerrollen.

  • Eine AWS CloudFormation IAM-Rolle zum Erstellen von Projektressourcen mithilfe AWS CloudFormation dieser Rolle umfasst Berechtigungen für alle AWS CloudFormation unterstützten Ressourcen, einschließlich IAM-Rollen.

  • Eine Toolchain-IAM-Rolle.

  • Im Anwendungsstapel definierte Ausführungsrollen für Lambda, die Sie ändern können.

• Vor dem 6. Dezember 2018 PDT:

  • Eine AWS CloudFormation IAM-Rolle für die Erstellung von Projektressourcen mit Unterstützung für einen begrenzten Satz von AWS CloudFormation-Ressourcen.

  • Eine IAM-Rolle zum Erstellen einer CodePipeline Ressource.

  • Eine IAM-Rolle zum Erstellen einer CodeBuild Ressource.

  • Eine IAM-Rolle zum Erstellen einer CodeDeploy Ressource, falls für Ihren Projekttyp zutreffend.

  • Eine IAM-Rolle für die Erstellung der Amazon EC2 EC2-Web-App, falls für Ihren Projekttyp zutreffend.

  • Eine IAM-Rolle für die Erstellung einer CloudWatch Events-Ressource.

  • Eine Ausführungsrolle für Lambda, die dynamisch geändert wird, um einen Teil der Ressourcen einzubeziehen.

Das Projekt umfasst Detailseiten, die den Status anzeigen und Links zur Teamverwaltung, Links zu Anweisungen zur Einrichtung von IDEs oder Ihrem Repository sowie einen Commit-Verlauf der Quellcodeänderungen im Repository enthalten. Sie können auch Tools zur Verbindung mit externen Tools zur Problemverfolgung auswählen, wie z.B. Jira.

Fangen Sie an: Wählen Sie eine Projektvorlage aus

Wenn Sie ein AWS CodeStar-Projekt in der Konsole auswählen, wählen Sie aus einer Reihe von vorkonfigurierten Optionen mit Beispielcode und Ressourcen, um einen schnellen Einstieg zu ermöglichen. Diese Optionen werden Projektvorlagen genannt. Jede AWS CodeStar Projektvorlage besteht aus einer Programmiersprache, einem Anwendungstyp und einer Rechenplattform. Die von Ihnen gewählte Kombination bestimmt die Projektvorlage.

Wählen Sie eine Compute-Plattform-Vorlage

Jede Vorlage konfiguriert einen der folgenden Compute-Plattform-Typen:

• Wenn Sie ein AWS Elastic Beanstalk Projekt auswählen, stellen Sie es in einer AWS Elastic Beanstalk Umgebung auf Amazon Elastic Compute Cloud-Instances in der Cloud bereit.

• Wenn Sie sich für ein Amazon EC2 EC2-Projekt entscheiden, AWS CodeStar erstellt Linux EC2-Instances, um Ihre Anwendung in der Cloud zu hosten. Ihre Projektteammitglieder können auf die Instances zugreifen, und Ihr Team verwendet das key pair, das Sie für SSH in Ihre Amazon EC2 EC2-Instances bereitstellen. AWS CodeStarhat auch ein verwaltetes SSH, das die Berechtigungen von Teammitgliedern verwendet, um Schlüsselpaarverbindungen zu verwalten.

• Wenn Sie dies wünschenAWS Lambda, AWS CodeStar wird eine serverlose Umgebung erstellt, auf die über Amazon API Gateway zugegriffen wird, ohne dass Instances oder Server verwaltet werden müssen.

Wählen Sie einen Vorlagen-Anwendungstyp aus

Jede Vorlage konfiguriert eine der folgenden Anwendungstypen:

• Webservice

  Ein Webservice wird für Aufgaben verwendet, die im Hintergrund laufen, wie z.B. der Aufruf von APIs. Nachdem AWS CodeStar Ihr Beispiel-Webservice-Projekt erstellt hat, können Sie die Endpunkt-URL wählen, um die Ausgabe von "Hello World" zu sehen, aber die primäre Verwendung dieses Anwendungstyps ist keine Benutzeroberfläche (UI). Die AWS CodeStar-Projektvorlagen in dieser Kategorie unterstützen die Entwicklung in Ruby, Java, ASP.NET, PHP und mehr.

• Webanwendung

  Eine Webanwendung verfügt über eine Benutzeroberfläche. Nachdem AWS CodeStar Ihr Beispiel-Webanwendungsprojekt erstellt hat, können Sie die Endpunkt-URL auswählen, um eine interaktive Webanwendung zu sehen. Die AWS CodeStar-Projektvorlagen in dieser Kategorie unterstützen die Entwicklung in Ruby, Java, ASP.NET, PHP und mehr.

• Statische Website

  Wählen Sie diese Vorlage, wenn Sie ein Projekt für eine HTML-Website benötigen. Die AWS CodeStar-Projektvorlagen in dieser Kategorie unterstützen die Entwicklung in HTML5.

• Alexa-Skill

  Wählen Sie diese Vorlage aus, wenn Sie ein Projekt für einen Alexa-Skill mit einer AWS Lambda-Funktion anlegen möchten. Wenn Sie das Skill-Projekt erstellen, CodeStar gibt AWS einen Amazon-Ressourcennamen (ARN) zurück, den Sie als Service-Endpunkt verwenden können. Weitere Informationen finden Sie unter Hosten eines benutzerdefinierten Skills als AWS Lambda-Funktion.

  Anmerkung

  Lambda-Funktionen für Alexa-Skills werden nur in den Regionen USA Ost (Nord-Virginia), USA West (Oregon), EU (Irland) und Asien-Pazifik (Tokio) unterstützt.

• Config-Regel

  Wählen Sie diese Vorlage, wenn Sie ein Projekt für eine AWS Config Regel erstellen möchten, mit der Sie Regeln für alle AWS Ressourcen in Ihrem Konto automatisieren können. Die Funktion gibt einen ARN zurück, die Sie als Service-Endpunkt für Ihre Regel verwenden können.

Wählen Sie eine Programmiersprachenvorlage

Wenn Sie eine Projektvorlage auswählen, wählen Sie eine Programmiersprache wie Ruby, Java, ASP.NET, PHP, Node.js und mehr.

Wie Sie Änderungen an Ihrem AWS CodeStar-Projekt vornehmen können

Sie können Ihr Projekt aktualisieren, indem Sie Folgendes ändern:

• Den Beispiel-Code und Programmiersprachenressourcen für Ihre Anwendung.

• Ressourcen, die die Infrastruktur bilden, in der Ihre Anwendung gespeichert und bereitgestellt wird (Betriebssysteme, unterstützende Anwendungen und Services, Bereitstellungsparameter und die Cloud-Compute-Plattform). Sie können die Anwendungsressourcen in der template.yml-Datei ändern. Dies ist die AWS CloudFormation-Datei, die die Laufzeitumgebung Ihrer Anwendung modelliert.

Anmerkung

Wenn Sie mit einem Alexa AWS CodeStar Skills-Projekt arbeiten, können Sie außerhalb des AWS CodeStar Quell-Repositorys (CodeCommit oder GitHub) keine Änderungen an dem Skill vornehmen. Wenn Sie den Skill im Alexa-Entwicklerportal bearbeiten, ist die Änderung möglicherweise nicht im Quell-Repository sichtbar und die beiden Versionen sind nicht synchron.

Ändern des Anwendungsquellcodes und Push von Änderungen

Um Beispiel-Quellcode, Skripte und andere Anwendungsquelldateien zu ändern, bearbeiten Sie Dateien in Ihrem Quell-Repository mit:

• Verwenden Sie den Bearbeitungsmodus in CodeCommit oder GitHub.

• Öffnen des Projekts in einer integrierten Entwicklungsumgebung (IDE), wie z. B. AWS Cloud9.

• Klonen des Repositorys lokal und dann Commit und Push Ihrer Änderungen. Weitere Informationen finden Sie unter Schritt 4: Bestätigen Sie eine Änderung.

Ändern von Anwendungsressourcen mit der Datei Template.yml

Anstatt eine Infrastrukturressource manuell zu ändern, verwenden Sie AWS CloudFormation, um die Laufzeitressourcen Ihrer Anwendung zu modellieren und bereitzustellen.

Sie können eine Anwendungsressource, wie beispielsweise eine Lambda-Funktion, in Ihrem Laufzeitstapel ändern oder hinzufügen, indem Sie die Datei template.yml in Ihrem Projektarchiv bearbeiten. Sie können jede Ressource hinzufügen, die als AWS CloudFormation-Ressource verfügbar ist.

Um den Code oder die Einstellungen einer AWS Lambda-Funktion zu ändern, siehe Hinzufügen einer Ressource zu einem Projekt.

Ändern Sie die Datei template.yml im Repository Ihres Projekts, um den Typ der AWS CloudFormation-Ressourcen hinzuzufügen, die Anwendungsressourcen sind. Wenn Sie eine Anwendungsressource zum Resources-Abschnitt der Datei template.yml hinzufügen, erstellen AWS CloudFormation und AWS CodeStar die Ressource für Sie. Eine Liste der AWS CloudFormation Ressourcen und ihrer erforderlichen Eigenschaften finden Sie unter Referenz zu AWS Ressourcentypen. Weitere Informationen finden Sie im Code-Beispiel unter Schritt 1: Bearbeiten Sie die CloudFormation Worker-Rolle in IAM.

AWS CodeStar ermöglicht die Implementierung von Bewährten Methoden durch Konfiguration und Modellierung der Laufzeitumgebung Ihrer Anwendung.

Wie man Berechtigungen zum Ändern von Anwendungsressourcen verwaltet

Wenn Sie AWS CloudFormation verwenden, um Laufzeit-Anwendungsressourcen hinzuzufügen, wie z.B. eine Lambda-Funktion, kann die AWS CloudFormation-Auftragnehmer-Rolle die bereits vorhandenen Berechtigungen verwenden. Für einige Ressourcen der Laufzeitanwendung müssen Sie die Berechtigungen der AWS CloudFormation-Workerrolle manuell anpassen, bevor Sie die Datei template.yml bearbeiten.

Ein Beispiel für das Ändern der Berechtigungen der AWS CloudFormation-Auftragnehmer-Rolle finden Sie unter Schritt 5: Hinzufügen von Ressourcenberechtigungen mit einer Inline-Richtlinie.