Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se describe cómo crear o actualizar recursos de grupos de adjuntos en Google Distributed Cloud (GDC) aislado.
Un grupo de adjuntos representa una colección de adjuntos de VLAN que comparten acceso a un conjunto de organizaciones. Un recurso AttachmentGroup enumera las organizaciones que pueden usar el reenvío y el enrutamiento virtuales (VRF) en el recurso InterconnectAttachment.
Los grupos de adjuntos son un recurso obligatorio para configurar una conexión segura aislada con un alto ancho de banda y una latencia baja.
Esta página está dirigida a los desarrolladores que pertenecen al grupo de operadores de aplicaciones y que desean establecer conectividad con interconexiones. Para obtener más información, consulta Audiences for GDC air-gapped documentation (Públicos para la documentación de GDC aislada del aire).
Antes de comenzar
Para crear o actualizar un grupo de archivos adjuntos, debes tener lo siguiente:
IDENTIFIER: Es una cadena de identificador único para el grupo de archivos adjuntos.
ORG_NAME: Es el nombre de la organización del arrendatario a la que se pueden conectar todos los adjuntos de VLAN del grupo de adjuntos. Debe ser el nombre de tu organización.
DOMAIN_TYPE: Es el dominio específico de la organización del arrendatario en la entrada a la que se pueden conectar todos los adjuntos de VLAN. Debes proporcionar uno de los siguientes valores válidos:
OrgAdmin: Conéctate a la infraestructura del plano de administración de la organización.
OrgData: Conéctate a la infraestructura del plano de datos de la organización.
OrgMixed: Usa el tipo OrgMixed para conectarte a la infraestructura del plano de administración de la organización y del plano de datos de la organización.
External: Usa el tipo External si la organización no es una organización de la arquitectura de Org v2.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eThis guide outlines the process for creating or updating an attachment group in Google Distributed Cloud (GDC) air-gapped environments.\u003c/p\u003e\n"],["\u003cp\u003eAn attachment group is a collection of VLAN attachments that share access to specified organizations, and it lists organizations permitted to use virtual routing and forwarding (VRF) on the \u003ccode\u003eInterconnectAttachment\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eCreating or updating an attachment group involves defining its configuration in a YAML file named \u003ccode\u003eattachmentgroup.yaml\u003c/code\u003e, including a unique identifier, the tenant organization name, and the domain type.\u003c/p\u003e\n"],["\u003cp\u003eYou can apply the configuration using \u003ccode\u003ekubectl\u003c/code\u003e and verify the successful creation of the attachment group by confirming that the \u003ccode\u003eReady\u003c/code\u003e column displays \u003ccode\u003eTrue\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Create an attachment group\n\nThis page describes how to create or update attachment group resources in Google Distributed Cloud (GDC) air-gapped.\n\nAn attachment group represents a collection of VLAN attachments that\nshare access to a set of organizations. An `AttachmentGroup` resource lists\nthe organizations allowed to use virtual routing and forwarding (VRF) on the\n`InterconnectAttachment` resource.\n\nAttachment groups are a required resource in setting up a secure air-gapped connection with high bandwidth and low latency.\n\nThis page is for developers within the application operator group who are looking to establish connectivity with interconnects. For more information, see [Audiences for GDC air-gapped documentation](/distributed-cloud/hosted/docs/latest/gdch/resources/audiences).\n\nBefore you begin\n----------------\n\nTo create or update an attachment group, you must have the following:\n\n- The necessary identity and access roles. For more information, see [Prepare predefined roles and permissions](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/interconnects/interconnect-overview#prepare-roles).\n\nCreate or update an attachment group\n------------------------------------\n\nTo create or update an attachment group, follow these steps:\n\n1. Create a YAML file named `attachmentgroup.yaml`.\n2. Add the following content to the file:\n\n apiVersion: system.private.gdc.goog/v1alpha1\n kind: AttachmentGroup\n metadata:\n name: attachment-group-\u003cvar translate=\"no\"\u003eIDENTIFIER\u003c/var\u003e\n namespace: gpc-system\n spec:\n identifier: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eIDENTIFIER\u003c/span\u003e\u003c/var\u003e\n entities:\n - orgName: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eORG_NAME\u003c/span\u003e\u003c/var\u003e\n domainType: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eDOMAIN_TYPE\u003c/span\u003e\u003c/var\u003e\n\n3. Replace the following:\n\n - \u003cvar translate=\"no\"\u003eIDENTIFIER\u003c/var\u003e: a unique identifier string for the attachment group.\n - \u003cvar translate=\"no\"\u003eORG_NAME\u003c/var\u003e: the name of the tenant organization that all VLAN attachments in the attachment group can connect to. This must be your organization's name.\n - \u003cvar translate=\"no\"\u003eDOMAIN_TYPE\u003c/var\u003e: the specific domain of the\n tenant organization in the entry that all VLAN attachments can\n connect to. You must provide one of the following valid values:\n\n - `OrgAdmin`: Connect to the Org Management-plane infrastructure.\n - `OrgData`: Connect to the Org Data-plane infrastructure.\n - `OrgMixed:` Use the `OrgMixed` type to connect to both the Org Management-plane and Org Data-plane infrastructure.\n - `External:` Use the `External` type if the organization is not an Org v2 Architecture organization.\n4. Create the attachment group:\n\n kubectl apply -f attachmentgroup.yaml -n gpc-system\n --kubeconfig=\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER\u003c/var\u003e with the path to the\n kubeconfig file for the Management API server.\n5. Check that the creation of attachment group is successful:\n\n kubectl get attachmentgroup -n gpc-system\n --kubeconfig=\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER\u003c/var\u003e\n\n The output returns the attachment group and shows `True` in the `Ready`\n column: \n\n NAME IDENTIFIER READY\n attachment-group-mixed mixed True\n\nWhat's next\n-----------\n\n- [Create a VLAN attachment](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/interconnects/create-vlan-attachment)"]]