O Mainframe Connector usa o Google Analytics para coletar dados de uso. Isso nos ajuda a melhorar o software e oferecer uma
experiência melhor ao usuário. Por padrão, o Google Analytics está ativado.
No entanto, é possível desativar essa opção configurando uma variável de ambiente ao
executar o Conector de mainframe.
O uso do Google Analytics está sujeito aos Termos de Serviço e à Política de Privacidade do Google Analytics.
Ao fazer o download do Mainframe Connector, você confirma que leu, entendeu e aceitou os Termos e Condições.
Extraia os arquivos no arquivo tar de implantação.
tar -xvf ./deployment.tar
Os arquivos main.tf e vars.tf são extraídos do
arquivo tar de implantação.
Revise e edite as variáveis no arquivo vars.tf. A maioria das
variáveis já tem valores padrão. As únicas variáveis obrigatórias que você precisa
definir são project e connector_service_account_email.
project:o projeto Google Cloud em que você quer
instalar o Mainframe Connector.
connector_service_account_email:a conta de serviço que
tem todas as permissões para as operações que você quer realizar usando o
Mainframe Connector.
Também é possível definir a configuração de rede usando as
variáveis connector_service_ingress e
connector_service_vpc_access.
Execute o comando terraform init
com um bucket e um prefixo do Cloud Storage como
argumentos. Usar um bucket e um prefixo do Cloud Storage ajuda a salvar o
estado da implantação no bucket. Também é possível reutilizar o mesmo bucket e prefixo
ao fazer upgrade do Mainframe Connector.
DEPLOYMENT_STATE_BUCKET: o nome do bucket do Cloud Storage.
BUCKET_PREFIX: o prefixo que você quer usar no bucket do Cloud Storage.
Crie um arquivo .tfvars para definir as variáveis que você quer que o Terraform use durante a implantação do Mainframe Connector.
Abra o arquivo .tfvars e defina as seguintes variáveis como
pares de chave-valor.
instance_id:defina um instance_id para
separar diferentes cargas de trabalho quando você quiser ter várias instâncias do
Mainframe Connector ou usar diferentes contas de serviço.
project:o projeto em que você quer implantar o
Mainframe Connector.
connector_service_ingress:o tipo de entrada.
additional_labels:rótulos adicionais se você quiser testar
a implantação.
connector_service_account_email:o ID de e-mail da conta de serviço
do Mainframe Connector.
Salve as alterações e feche o arquivo.
Implante o Mainframe Connector.
terraform apply -var-file=VARIABLE_FILE_NAME
Substitua VARIABLE_FILE_NAME pelo arquivo de variáveis que você criou na
etapa anterior.
(Opcional) Para verificar se o conector de mainframe está implantado e em execução,
acesse a página do Cloud Run e selecione a guia Services. A implantação
vai aparecer na tabela.
Implantar várias instâncias do Mainframe Connector
Para limitar o acesso a jobs específicos, talvez seja necessário implantar várias instâncias
do Mainframe Connector. Para isso, implante o
conector de mainframe várias vezes com diferentes variáveis e contas de serviço. Como o serviço remoto do Mainframe Connector é baseado no
Cloud Run, você só vai receber cobranças quando cada serviço estiver em execução.
Também não é necessário configurar a alta disponibilidade (HA), já que cada instância já está
balanceada de carga e altamente disponível.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-03 UTC."],[],[],null,["# Deploy Mainframe Connector on Cloud Run\n\nThis page discusses how you can deploy Mainframe Connector on\nCloud Run as a remote service using [Terraform](https://www.terraform.io/).\nYou can then use the Mainframe Connector remote service to transcode,\nstore, and export mainframe data on Google Cloud. You can trigger this service\nfrom your mainframe to [perform remote transcoding](/mainframe-connector/docs/remote-transcoding),\nor as a [standalone instance that is integrated with an existing extract, transfer, and load (ETL) workflow](/mainframe-connector/docs/standalone-mode).\n\nYou can also deploy multiple instances of the Mainframe Connector\nremote service. For more information, see [Deploy multiple instances of the Mainframe Connector](#deploy-multiple-instances).\n\nTo deploy Mainframe Connector on Cloud Run using\n[Terraform](https://www.terraform.io/), use the following steps:\n\n1. Download the [Mainframe Connector deployment tar file]().\n\n ### Important\n\n Be aware that Mainframe Connector uses Google Analytics\n to collect usage data. This helps us improve the software and provide a\n better user experience. By default, Google Analytics is enabled.\n However, you can opt out by configuring an [environment variable](/mainframe-connector/docs/environment-variables#disable_analytics) when\n running Mainframe Connector.\n\n\n \u003cbr /\u003e\n\n\n The use of Google Analytics is subject to the Google Analytics\n [Terms of Service and Privacy Policy](https://www.google.com/analytics/terms).\n By downloading Mainframe Connector, you acknowledge that you have\n read, understood, and accepted the terms and conditions. \n [Download](https://storage.googleapis.com/mainframe-connector-release/latest/deployment.tar) Cancel\n2. Extract the files in the deployment tar file.\n\n ```\n tar -xvf ./deployment.tar\n ```\n\n The `main.tf` and `vars.tf` files are extracted from\n deployment tar file.\n3. Review and edit the variables in the `vars.tf` file. Most of the\n variables already have default values. The only mandatory variables you need\n to set are `project` and `connector_service_account_email`.\n\n - **`project`:** The Google Cloud project in which you want to install Mainframe Connector.\n - **`connector_service_account_email`:** The service account that has all the permissions for the operations you want to perform using Mainframe Connector.\n\n You can also set the network configuration using the\n `connector_service_ingress` and `connector_service_vpc_access`\n variables.\n4. Run the [`terraform init`](https://developer.hashicorp.com/terraform/cli/commands/init)\n command with a Cloud Storage *bucket* and *prefix* as\n arguments. Using a Cloud Storage bucket and prefix helps you save the\n deployment state in the bucket. You can also reuse the same bucket and prefix\n when you upgrade Mainframe Connector.\n\n ```\n terraform init \\\n -backend-config bucket=DEPLOYMENT_STATE_BUCKET \\\n -backend-config prefix=BUCKET_PREFIX\n ```\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eDEPLOYMENT_STATE_BUCKET\u003c/var\u003e: The name of the Cloud Storage bucket.\n - \u003cvar translate=\"no\"\u003eBUCKET_PREFIX\u003c/var\u003e: The prefix that you want to use in the Cloud Storage bucket.\n5. Create a `.tfvars` file to define variables that you want\n Terraform to use during the Mainframe Connector deployment.\n\n6. Open the `.tfvars` file and define the following variables as\n key-value pairs.\n\n - **`instance_id`:** Define an `instance_id` to separate different workloads when you want to have multiple instances of Mainframe Connector, or to use different service accounts.\n - **`project`:** The project in which you want to deploy Mainframe Connector.\n - **`connector_service_ingress`:** The ingress type.\n - **`additional_labels`:** Additional labels if you want to test the deployment.\n - **`connector_service_account_email`:** The service account email ID of Mainframe Connector.\n\n Save your changes and close the file.\n7. Deploy Mainframe Connector.\n\n ```\n terraform apply -var-file=VARIABLE_FILE_NAME\n ```\n\n Replace \u003cvar translate=\"no\"\u003eVARIABLE_FILE_NAME\u003c/var\u003e with the variables file you created in\n the previous step.\n8. (Optional) To check if Mainframe Connector is deployed and running,\n go to the Cloud Run page, and select the **Services** tab. You\n should see your deployment listed in the table.\n\n [Go to Cloud Run](https://console.cloud.google.com/run?enableapi=true)\n\nDeploy multiple instances of the Mainframe Connector\n----------------------------------------------------\n\nTo limit access for specific jobs, you might need to deploy multiple instances\nof the Mainframe Connector. You can do this by deploying the\nMainframe Connector multiple times with different variables and service\naccounts. Since the Mainframe Connector remote service is based on\nCloud Run, you will only be billed when each service is actually running.\nYou also don't need to set up high availability (HA) as each instance is already\nload balanced and highly available.\n\nWhat's next\n-----------\n\n- [Transcode mainframe data remotely on Google Cloud](/mainframe-connector/docs/remote-transcoding)\n- [Transcode mainframe data moved to Google Cloud using a virtual tape library](/mainframe-connector/docs/vtl-transcoding)\n- [Run Mainframe Connector as a standalone job](/mainframe-connector/docs/standalone-mode)"]]
