Projekte erstellen

Projekte sind die grundlegende Betriebseinheit in der Cloud de Confiance by S3NS Ressourcenhierarchie. Projekte befinden sich zwischen Ordnern (oder der Organisation) und Ressourcen wie virtuellen Maschinen und Speicher. Auf dieser Seite wird erläutert, wie SieCloud de Confiance -Projekte mit der Cloud Resource Manager API und der Cloud de Confiance Console erstellen.

Zu den wichtigsten Merkmalen von Projekten gehören:

  • Der primäre Dienstcontainer: Ein Projekt ist die Basisebene, auf der alleCloud de Confiance by S3NS -Dienste (APIs) aktiviert sind und auf der Ressourcen wie Compute Engine-Instanzen oder BigQuery-Datasets erstellt werden.

  • 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 für Unternehmen, Kosten in ihrer Organisation zu verfolgen, zu organisieren und zu trennen.

  • Der Richtlinienanhangspunkt: Richtlinien werden zwar häufig von Ordnern übernommen, aber die Projektebene ist der häufigste Ort, an dem Entwicklern und Dienstkonten für tägliche Aufgaben bestimmte Berechtigungen (Identity and Access Management, IAM) gewährt werden.

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 Cloud de Confiance Landing-Zone festlegen.

Die folgenden IDs werden für Ihr Projekt verwendet:

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

    Der Projektname muss die folgenden Anforderungen erfüllen:

    • Er muss zwischen 4 und 30 Zeichen lang sein.
    • Er kann Buchstaben, Zahlen, einfache Anführungszeichen, Bindestriche, Leerzeichen oder Ausrufezeichen enthalten.
    • Sie 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, mit dem Ihr Projekt von allen anderen in Cloud de Confiance by S3NSunterschieden wird. Nachdem Sie einen Projektnamen eingegeben haben, generiert dieCloud de Confiance 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 der Projekterstellung ist die Projekt-ID dauerhaft.

    Eine Projekt-ID muss die folgenden Anforderungen erfüllen:

    • 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 in Verwendung sein oder zuvor verwendet worden sein, auch nicht in gelöschten Projekten.
    • Es darf keine eingeschränkten Strings wie google und ssl enthalten. Vermeiden Sie die Verwendung von Strings wie undefined und null in einer Projekt-ID.

    Alle Cloud de Confiance-Projekt-IDs haben automatisch das Präfix s3ns:.

  • 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 Cloud de Confiance by S3NS-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 „Projektersteller“ (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 Cloud de Confiance -Konsole, der Google Cloud CLI oder der projects.create()-Methode erstellen.

Console

So erstellen Sie ein neues Projekt:

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

    Zur Seite „Ressourcen verwalten“

    Die verbleibenden Schritte werden in der Cloud de Confiance 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.
  5. Nachdem Sie die Details zum neuen Projekt eingegeben haben, klicken Sie auf Erstellen.

gcloud

  1. Aktivieren Sie Cloud Shell in der Cloud de Confiance Console.

    Cloud Shell aktivieren

    Unten in der Cloud de Confiance 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.

    Verwenden Sie zum Erstellen eines Projekts mit einer Organisationsressource oder einem Ordner als übergeordnetes Element die Flags --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, das nicht automatisch mit einem Rechnungskonto verknüpft wird. 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 bei der Projekterstellung hinzufügen

Mit Tags können Sie Anmerkungen 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 beim Erstellen eines Projekts Tags 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 zeigt eine JSON-Anfrage, mit der Sie ein Projekt erstellen und ihm 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 lassen sich Fehler vermeiden und Sie werden besser darauf aufmerksam gemacht, wenn Sie in sensiblen Umgebungen arbeiten. Google fügt dem Projekt in der Projektauswahl der Cloud de Confiance -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 Nichtproduktionsanwendungen auswirken können. Tags können entweder vom Projekt übernommen oder direkt für das Projekt festgelegt werden.

So verwenden Sie diese Funktion:

  1. Erstellen Sie einen Tag-Schlüssel mit dem Namen environment.
  2. Tag-Werte für die verwendeten Umgebungskategorien erstellen 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 Umgebungstags 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 Dienstkonten die Berechtigung zum Erstellen von Projekten innerhalb einer Organisationsressource erhalten. 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

Wenn Sie zusätzliche Kapazität für Projekte in Ihrem Organisationskontingent anfordern möchten, erstellen Sie ein Support-Ticket für das Cloud de Confiance by S3NS -Team. Weitere Informationen finden Sie unter Kontingentanpassung anfordern.

Nächste Schritte