Projekte erstellen

Projekte sind die grundlegende Betriebseinheit in der Ressourcenhierarchie von Google Cloudund ermöglichen es Ihnen, Ihre Cloud-Ressourcen zu organisieren, zu isolieren und zu steuern. Projekte befinden sich zwischen Ordnern (oder der Organisationsressource) und Dienstressourcen wie virtuellen Maschinen und Speicher. Sie helfen Ihnen, APIs, Abrechnung und Berechtigungen in verschiedenen Umgebungen zu verwalten. Zum Erstellen und Verwalten von Projekten können Sie die Google Cloud Console, die Google Cloud CLI oder die Cloud Resource Manager API verwenden.

Wichtige Merkmale von Projekten

Zu den wichtigsten Merkmalen von Projekten gehören:

  • Der primäre Dienstcontainer: Ein Projekt ist die Basisebene, auf der Sie Google Cloud -Dienste (APIs) aktivieren und Ressourcen wie Compute Engine-Instanzen oder BigQuery-Datasets erstellen.

  • Die Vertrauensgrenze: Projekte dienen als Isolationsschicht. Standardmäßig haben Ressourcen in einem Projekt keinen Zugriff auf Ressourcen in einem anderen Projekt. Dadurch wird ein sicherer Perimeter für verschiedene Anwendungen oder Umgebungen geschaffen.

  • Die Abrechnungseinheit: Projekte sind die wichtigste Möglichkeit, Kosten in Ihrer Organisation zu verfolgen, zu organisieren und zu trennen.

  • Der Richtlinien-Anhangspunkt: Obwohl Projekte Richtlinien von Ordnern und der Organisationsressource übernehmen, ist die Projektebene der häufigste Ort, an dem Sie Entwicklern und Dienstkonten für tägliche Aufgaben bestimmte IAM-Berechtigungen (Identity and Access Management) gewähren.

Hinweis

Informationen zur Projektressource finden Sie in der Übersicht über die Ressourcenhierarchie. Eine Anleitung zum Einrichten Ihrer Ressourcenhierarchie finden Sie unter Ressourcenhierarchie für Ihre Google Cloud -Landing-Zone festlegen.

Die folgenden Kennungen werden für Ihr Projekt verwendet:

  • Projektname: Ein menschenlesbarer Name für Ihr Projekt.

    Für den Projektnamen gelten die folgenden Anforderungen:

    • Er muss zwischen 4 und 30 Zeichen lang sein.
    • Er kann Buchstaben, Zahlen, einfache Anführungszeichen, Bindestriche, Leerzeichen oder Ausrufezeichen enthalten.
    • Er muss mit einem Buchstaben oder einer Ziffer enden.

    Der Projektname wird von den Google APIs nicht verwendet. Sie können den Projektnamen während oder nach der Projekterstellung bearbeiten. Projektnamen müssen nicht eindeutig sein.

  • Projekt-ID: Eine global eindeutige Kennung für Ihr Projekt.

    Eine Projekt-ID ist ein eindeutiger String, der Ihr Projekt von allen anderen in Google Cloudunterscheidet. Nachdem Sie einen Projektnamen eingegeben haben, generiert dieGoogle Cloud Console eine eindeutige Projekt-ID, die eine Kombination aus Buchstaben, Zahlen und Bindestrichen sein kann. Verwenden Sie die generierte Projekt-ID. Sie können sie jedoch während der Projekterstellung bearbeiten. Nach dem Erstellen des Projekts ist die Projekt-ID dauerhaft.

    Für eine Projekt-ID gelten die folgenden Anforderungen:

    • Sie muss zwischen 6 und 30 Zeichen lang sein.
    • Er darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten.
    • Er muss mit einem Buchstaben beginnen.
    • Es darf nicht mit einem Bindestrich enden.
    • Sie darf nicht verwendet werden oder zuvor verwendet worden sein. Dies gilt auch für gelöschte Projekte.
    • Er darf keine eingeschränkten Strings wie google und ssl enthalten. Vermeiden Sie Strings wie undefined und null in einer Projekt-ID.

  • Projektnummer: Eine Projektnummer ist eine automatisch generierte eindeutige Kennung für Ihr Projekt. Informationen zum Ermitteln der Projektnummer finden Sie unter Projekte identifizieren.

Der Projektname, die Projekt-ID und andere Ressourcennamen dürfen keine vertraulichen Informationen wie personenidentifizierbare Informationen oder Sicherheitsdaten enthalten. Die Projekt-ID wird im Namen vieler anderer Google Cloud-Ressourcen angezeigt. Wenn Sie auf das Projekt oder seine Ressourcen verweisen, werden die Projekt-ID und der Ressourcenname offengelegt.

Projekt erstellen

Zum Erstellen eines Projekts benötigen Sie die Berechtigung resourcemanager.projects.create. Diese Berechtigung ist in Rollen wie der Rolle „Project Creator“ (roles/resourcemanager.projectCreator) enthalten.

Informationen dazu, wie Sie Einzelpersonen die Rolle zuweisen und den Zugriff auf die gesamte Organisationsressource einschränken, finden Sie auf der Seite Standardmäßige Organisationsrollen verwalten.

Wenn Sie die übergeordnete Ressource nicht angeben, wird automatisch eine übergeordnete Ressource ausgewählt, sofern dies anhand der Domain des Nutzerkontos möglich ist.

Sie können ein neues Projekt mit der Google Cloud Console, der Google Cloud CLI oder der Methode projects.create() erstellen.

Console

So erstellen Sie ein neues Projekt:

  1. Öffnen Sie in der Google Cloud Console die Seite Ressourcen verwalten.

    Zur Seite „Ressourcen verwalten“

    Die verbleibenden Schritte werden in der Google Cloud Console angezeigt.

  2. Klicken Sie auf Projekt erstellen.
  3. Geben Sie im angezeigten Fenster Neues Projekt einen Projektnamen ein und wählen Sie ggf. ein Rechnungskonto aus. Ein Projektname darf nur Buchstaben, Zahlen, einfache Anführungszeichen, Bindestriche, Leerzeichen oder Ausrufezeichen enthalten und muss zwischen 4 und 30 Zeichen lang sein.
  4. Geben Sie die übergeordnete Organisations- oder Ordnerressource in das Feld Übergeordnete Ressource ein. Diese Ressource ist das hierarchisch übergeordnete Element des neuen Projekts. Wenn die Option Keine Organisation angezeigt wird, können Sie sie auswählen, um das neue Projekt als oberste Ebene seiner eigenen Ressourcenhierarchie zu erstellen.
  5. Nachdem Sie die Details zum neuen Projekt eingegeben haben, klicken Sie auf Erstellen.

gcloud

  1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

  2. Verwenden Sie zum Erstellen eines neuen Projekts den Befehl gcloud projects create:

    gcloud projects create PROJECT_ID

    Dabei steht PROJECT_ID für die ID des Projekts, das Sie erstellen möchten. Die Projekt-ID muss mit einem Kleinbuchstaben beginnen, 6 bis 30 Zeichen lang sein und darf nur ASCII-Buchstaben, Ziffern oder Bindestriche enthalten.

    Wenn Sie ein Projekt mit einer Organisationsressource oder einem Ordner als übergeordnetes Element erstellen möchten, verwenden Sie das Flag --organization oder --folder. Da einer Ressource nur ein Element übergeordnet sein darf, kann nur eines dieser Flags verwendet werden:

    gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID

    gcloud projects create PROJECT_ID --folder=FOLDER_ID

REST

Wenn Sie mit der Methode projects.create() ein neues Projekt erstellen, können Sie in der Projekt-ID bestimmte Wörter nicht verwenden. Beispiele: google, null, undefined und ssl. Wenn Sie ein eingeschränktes Wort verwenden, wird die Anfrage mit dem Fehler INVALID_ARGUMENT zurückgegeben.

Mit der folgenden Anfrage wird nur ein Projekt erstellt und nicht automatisch mit einem Rechnungskonto verknüpft. Verwenden Sie die Methode projects.updateBillingInfo, um das mit einem Projekt verknüpfte Rechnungskonto festzulegen oder zu aktualisieren.

Anfrage zum Erstellen eines Projekts:

POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json

{
    "projectId": "our-project-123",
    "name": "my project",
    "labels": {
      "mylabel": "prod"
    }
}

Antwort zum Erstellen eines Projekts:

{
    "name": "operations/pc.123456789",
}

Anfrage zum Abrufen des Vorgangs:

GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json

Antwort zum Abrufen des Vorgangs:

{
    "name": "operations/pc.123456789",
    "done": true,
    "response": {
        "@type": "type.googleapis.com/google.cloudresourcemanager.v3.Project",
        "projectNumber": "464036093014",
        "projectId": "our-project-123",
        "lifecycleState": "ACTIVE",
        "name": "my project",
        "labels": {
        "mylabel": "prod"
        },
    "createTime": "2016-01-07T21:59:43.314Z"
    }
}

Tags während der Projekterstellung hinzufügen

Mit Tags können Sie Annotationen für Ressourcen erstellen. Sie können Tags beim Erstellen von Projekten hinzufügen. Sie müssen die Rolle Tag-Nutzer zuweisen, wenn Sie Tags hinzufügen. Weitere Informationen zu den Berechtigungen, die dieser Rolle zugewiesen sind, finden Sie unter Tags für Ressourcen verwalten. Sie können den Namespace für die Tag-Schlüssel/Wert-Paare nur auf eine der folgenden Arten hinzufügen:

gcloud

Führen Sie den folgenden Befehl aus, um Tags während der Projekterstellung hinzuzufügen:

gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS

Ersetzen Sie Folgendes:

  • PROJECT_ID ist die eindeutige Kennung des Projekts.
  • ORGANIZATION_ID ist die eindeutige Kennung der Organisation.
  • KEY_VALUE_PAIRS ist eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Sie Ihrer Ressource zuweisen können. Ein Beispiel für kommagetrennte Schlüssel/Wert-Paare ist 123/environment=production, 456/create=testresource. In diesem Beispiel sind 123 und 456 die eindeutigen Kennungen (IDs) der Organisations- oder Ordnerressourcen, in denen die Tag-Schlüssel definiert sind.

REST

Das folgende Snippet ist eine JSON-Anfrage, mit der Sie ein Projekt erstellen und Tags hinzufügen.

  POST https://cloudresourcemanager.googleapis.com/v3/projects/
  Authorization: *************
  Content-Type: application/json

  {
    "projectId": "our-project-456",
    "name": "my project",
    "parent": "organizations/123",
    "tags": {
      "key": "123/environment"
      "value": "production"
    },
"tags": {
      "key": "123/costCenter"
      "value": "marketing"
  }
}

Projektumgebungen mit Tags kennzeichnen

Mit Tags können Sie Projekte visuell nach ihrer Umgebung unterscheiden, z. B. Produktion, Staging oder Entwicklung. So können Sie Fehler vermeiden und die Aufmerksamkeit erhöhen, wenn Sie in sensiblen Umgebungen arbeiten. Google fügt dem Projekt in der Projektauswahl der Google Cloud Console einen visuellen Indikator hinzu, wenn ein Projekt mit einem bestimmten Tag-Schlüssel/Wert-Paar ausgewählt wird. Diese Kennzeichnung erinnert Sie daran, dass sich Änderungen auf Ihre zugehörigen Produktions- oder Nicht-Produktionsanwendungen auswirken können. Tags können entweder vom Projekt übernommen oder direkt im Projekt festgelegt werden.

So verwenden Sie diese Funktion:

  1. Erstellen Sie einen Tag-Schlüssel mit dem Namen environment.
  2. Erstellen Sie Tag-Werte für die von Ihnen verwendeten Umgebungskategorien. Die folgenden Werte werden unterstützt und einem entsprechenden Badge in der Projektauswahl der Console zugeordnet:
    • Prod: Prod, prod, Production, production
    • Dev: Dev, dev, Development, development
    • Test: Test, test, Testing, testing, QA, qa, Quality assurance, quality assurance
    • Staging: Staging, staging, Stage, stage
  3. Hängen Sie das entsprechende Tag an Ihr Projekt an, indem Sie eine Tag-Bindung erstellen.

Wenn ein Projekt mehrere Umgebungs-Tags hat (z. B. eines, das von einem Ordner übernommen wurde, und eines direkt im Projekt), wird das spezifischste Tag verwendet, um das Badge zu bestimmen.

Projekt mithilfe eines Dienstkontos erstellen

Sie können ein Dienstkonto verwenden, um die Projekterstellung zu automatisieren. Wie Nutzerkonten können auch Dienstkonten die Berechtigung erhalten, Projekte innerhalb einer Organisationsressource zu erstellen. Dienstkonten dürfen keine Projekte außerhalb einer Organisationsressource erstellen und müssen beim Erstellen eines Projekts die übergeordnete Ressource angeben. Dienstkonten können ein neues Projekt mit der gcloud CLI oder der Methode projects.create() erstellen.

Projektkontingente verwalten

Ein Nutzer oder Dienstkonto kann nur eine beschränkte Anzahl von Projekten erstellen. Wenn Sie ein Projekt außerhalb einer Organisationsressource erstellen, wird das Kontingent Ihres Nutzerkontos verwendet. Wenn Sie ein Projekt innerhalb einer Organisationsressource erstellen, wird das Kontingent sowohl für Ihr Nutzerkonto als auch für die Organisationsressource geprüft. Wenn für eines der beiden Kontingente noch Kontingent verfügbar ist, kann das Projekt erstellt werden.

Wenn in Ihrem Kontingent weniger als 30 Projekte vorhanden sind, wird die Anzahl der im Kontingent verbleibenden Projekte in einer Meldung auf der Seite Neues Projekt angezeigt. Wenn Sie Ihr Projektlimit erreicht haben, müssen Sie eine Erhöhung des Projektlimits beantragen, um weitere Projekte erstellen zu können. Es besteht aber auch die Möglichkeit, auf der Seite Ressourcen verwalten das Löschen einiger Projekte nach 30 Tagen zu planen. Projekte, die Nutzer vorläufig gelöscht haben, werden auf Ihr Kontingent angerechnet. Diese Projekte werden nach 30 Tagen vollständig gelöscht.

So fordern Sie zusätzliche Kapazität für Projekte in Ihrem Organisationskontingent an:

  1. Rufen Sie die Seite Kontingente und Systemlimits auf.

    Zur Seite „Kontingente und Systemlimits“

  2. Wählen Sie in der Ressourcenauswahl die Organisation aus, für die Sie das Projektkontingent erhöhen möchten.

  3. Wählen Sie unter Filter die Option Messwert aus und geben Sie cloudresourcemanager.googleapis.com/projects_count ein.

  4. Wählen Sie Cloud Resource Manager API aus, klicken Sie auf Weitere Aktionen und wählen Sie dann Kontingent bearbeiten aus.

  5. Geben Sie im Dialogfeld Kontingentänderungen einen neuen Kontingentwert und eine Beschreibung ein und klicken Sie dann auf Weiter.

  6. Geben Sie Ihre Kontaktdaten ein und klicken Sie auf Anfrage senden.

Sie erhalten eine E‑Mail, in der der Eingang Ihrer Anfrage bestätigt wird. Falls Sie weitere Hilfe benötigen, antworten Sie einfach auf diese E‑Mail. Nach der Prüfung erhalten Sie eine E‑Mail-Benachrichtigung, in der Sie darüber informiert werden, ob Ihre Anfrage genehmigt wurde.

Wenn Sie keine Organisation haben und zusätzliche Kapazität für Projekte in Ihrem Kontingent anfordern möchten, verwenden Sie das Formular Erhöhung des Projektkontingents anfordern.

Nächste Schritte