Perguntas gerais mais frequentes

As respostas às perguntas mais frequentes sobre o IBM Cloud Schematics estão organizadas na seção a seguir.

O que é o IBM Cloud Schematics e como ele funciona?

IBM Cloud Schematics oferece ferramentas avançadas para automatizar o processo de provisionamento e gerenciamento da infraestrutura de nuvem. E a configuração, a operação de seus recursos de nuvem e a implantação de suas cargas de trabalho de aplicativos.

Para isso, o Schematics utiliza projetos de código aberto, como o Terraform, Ansible, Red Hat OpenShift, Operators e Helm, e oferece esses recursos a você como um serviço gerenciado. Em vez de instalar cada projeto de código aberto em seu sistema, e aprender a API ou CLI. Você pode declarar as tarefas que você deseja executar em IBM Cloud e assistir Schematics executar essas tarefas para você.

Para obter mais informações sobre como o Schematics funciona, consulte Sobre o IBM Cloud Schematics.

O que é o Infrastructure as Code?

A Infraestrutura como Código ( IaC ) permite que você codifique seu ambiente de nuvem para automatizar o provisionamento e o gerenciamento de recursos em nuvem. Em vez de provisionar e configurar manualmente os recursos de infraestrutura ou usar scripts para ajustar seu ambiente de nuvem, você utiliza uma linguagem de script de alto nível para definir seus recursos e suas configurações. Ferramentas como o Terraform provisionam esses recursos na nuvem por meio de sua API. Como o código da sua infraestrutura é tratado da mesma forma que o código da sua aplicação, você pode aplicar práticas d DevOps, como controle de versão, testes e monitoramento contínuo.

Posso usar o Terraform IBM Modules com Schematics para provisionar a infraestrutura necessária?

Sim, você pode usar o Terraform IBM Modules(TIM) com Schematics para provisionar a infraestrutura. Os módulos do Terraform IBM são módulos pré-construídos, validados e prontos para a empresa que seguem as práticas recomendadas do IBM Cloud. Esses módulos podem ser referenciados diretamente em suas configurações do Terraform e usados com os espaços de trabalho do Schematics para provisionar recursos do IBM Cloud com eficiência. Para obter mais informações e módulos disponíveis, consulte o Registro do Terraform.

Qual é o custo cobrado pelo uso do site Schematics?

As áreas de trabalho do IBM Cloud Schematics são fornecidas a você gratuitamente. No entanto, quando você decide aplicar seu modelo do Terraform no IBM Cloud clicando em “ Apply plan ” na página de detalhes do espaço de trabalho ou executando o comando “ ibmcloud schematics apply ”, são cobrados os recursos do Cloud descritos no seu modelo do Terraform. Revise os planos de serviço disponíveis e as informações de precificação para cada recurso que você está prestes a criar. Alguns serviços são fornecidos com um limite por conta do IBM Cloud. Se estiver prestes a atingir o limite de serviço para sua conta, o recurso não será provisionado até que você aumente a cota de serviço ou remova os serviços existentes primeiro.

O uso do comando Schematics ibmcloud terraform exibe uma mensagem de aviso e depreciação como Alias Terraform are deprecated. Use schematics or sch em seu comando.

Como salvar arquivos entre operações?

Schematics persiste arquivos que são gravados no caminho /tmp/.schematics durante operações de ação e de área de trabalho. Os arquivos são restaurados para o mesmo caminho ao executar a próxima operação na área de trabalho O limite de arquivos é de 10 MB.

Falhas de tarefas devido a arquivos removidos ou ausentes da área de trabalho ou repositórios de modelo de ações (Ansible)

As falhas no trabalho ocorrem devido a arquivos removidos ou perdidos do repositório de modelos Git após a importação ou clonagem do repositório para Schematics.

Os arquivos podem estar ausentes no momento da execução por vários motivos: - Os arquivos são referenciados por meio do sistema de arquivos symlinks para diferentes arquivos ou pastas no repositório ou para sistemas de arquivos externos. - O conteúdo do repositório foi carregado como um TGZ e os arquivos referenciados pelos submódulos Git ou symlinks não foram incluídos no TGZ. - Os arquivos foram considerados vulneráveis ou maliciosos pelo site Schematics.

Arquivos que são removidos usando o Terraform ou os repositórios de modelos do Ansible

Para proteger os usuários contra agentes mal-intencionados, o Schematics remove arquivos dos repositórios Git clonados pelos usuários que possam afetar a segurança ou a integridade do serviço. A intenção é proteger os usuários contra a execução de módulos ou execuções não autorizados que possam afetar o serviço. Os arquivos que são empacotados como arquivos compactados, como zip ou tar, são automaticamente excluídos dos repositórios do usuário. O conteúdo do arquivo tar não é inspecionado. Da mesma forma, o uso de arquivos superiores a 500KB não é suportado (permitido) em repositórios de modelos, onde os arquivos de configuração típicos de IaC são KB.

Se quiser trabalhar com os arquivos, eles podem ser importados para Schematics em tempo de execução em /tmp ou mantidos em /tmp/.schematics. Somente arquivos com menos de 10 MB são mantidos entre execuções de tarefas.

Ao criar espaços de trabalho ou ações d Schematics, o IBM Cloud Schematics clona uma cópia do modelo do Terraform, ou Ansible, do seu repositório Git e a armazena em um local seguro. Antes dos arquivos de modelo serem salvos, o Schematics analisa o conteúdo e os arquivos considerados maliciosos ou vulneráveis são removidos. Uma lista de permissões é usada para permitir apenas arquivos autorizados. A remoção do arquivo é baseada nos seguintes critérios:

  • As extensões de arquivo permitidas são .cer, .cfg, .conf, .crt, .der, .gitignore, .html, .j2, .jacl, .js, .json, .key, .md, .netrc, .pem, .properties, .ps1, .pub, .py, .service, .sh, .tf, .tf.json, .tfvars, .tmpl, .tpl, .txt, .yaml, .yml, .zip, _rsa, license
  • As extensões de imagem permitidas são .bmp, .gif, .jpeg, .jpg, .png, .so .tif, .tiff
  • Os arquivos que são removidos explicitamente são .asa, .asax, .exe, .php5, .pht, .phtml, .shtml, .swf, .tfstate, .tfstate.backup, .xap, .zip, .tar.
  • Todos os arquivos maiores do que 500 KB são removidos Este limite de arquivo não se aplica aos tipos de arquivo de imagem permitidos
  • Quando o nome da pasta começa com um (ponto) ., ele é tratado como malicioso e removido.

A lista de extensão permitida é continuamente monitorada e atualizada em cada liberação. Você pode abrir um ticket de suporte solicitando a inclusão de uma extensão de arquivo na lista.

Há suporte para o uso dos submódulos Git nos repositórios Git ou nos arquivos TGZ?

O uso de submódulos Git é suportado apenas para repositórios Git clonados. Quando o Schematics clona o repositório Git, os submódulos Git são importados. Quando os repositórios são carregados como arquivos TGZ, o Schematics não usa uma operação de clonagem e os arquivos ou pastas referenciados pelo submódulo Git não são incluídos. Ao usar arquivos TGZ, todos os arquivos exigidos pelos submódulos Git ou symlinks devem ser incluídos no TGZ.

Existe um limite de taxa?.

IBM Cloud Schematics suporta 50 solicitações de API por minuto, por região e por usuário. As regiões são us-east, us-south, eu-gb ou eu-de.. Aguarde para iniciar o comando novamente.

Por que os trabalhos são aguardados em uma fila de execução?

O IBM Cloud Schematics enfileira todos as tarefas de usuários em uma única fila. Dependendo da carga de trabalho dos usuários e do tempo necessário para executar as tarefas, o usuário pode enfrentar atrasos. Para obter mais informações, consulte Status da fila de tarefas..

Como gerar o token de acesso do IAM, se o ID do cliente bx for usado?

Para criar o token de acesso IAM, use export IBMCLOUD_API_KEY=<ibmcloud_api_key> e execute o comando.

curl -X POST "https://iam.cloud.ibm.com/identity/token" -H "Content-Type: application/x-www-form-urlencoded" -d "grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey=$IBMCLOUD_API_KEY" -u bx:bx.

Para obter mais informações, consulte token de acesso IAM e Criar chave API. Você pode definir os valores das variáveis de ambiente export ACCESS_TOKEN=<access_token> e export REFRESH_TOKEN=<refresh_token>.

Como corrigir a falha ao clonar o repositório Git? Talvez não seja possível encontrar a referência remota, os cabeçalhos ou o mestre, provavelmente o nome inválido da ramificação foi passado?

Ao utilizar o repositório da ramificação https://github.com/guruprasad0110/tf_cloudless_sleepy_13/ após 1º de outubro de 2020, pode aparecer esta mensagem de erro.

Se o repositório for criado após 1º de outubro de 2020, a sintaxe do branch principal deve ser https://github.com/username/reponame/tree/main. Por exemplo, https://github.com/guruprasad0110/tf_cloudless_sleepy_13/tree/main

É possível aumentar o tempo de espera para os recursos null-exec e remote-exec?

Não, os recursos null-exec (null_resources) e remote-exec têm um tempo máximo de espera de 60 minutes. Tarefas mais longas precisam ser quebradas em blocos mais curtos para provisionar a infraestrutura mais rapidamente. Caso contrário, a execução expira automaticamente após 60 minutes.

Como posso salvar arquivos definidos pelo usuário nos módulos do Terraform e usá-los em vários comandos do Terraform?

IBM Cloud Schematics já armazena e gerencia com segurança o arquivo de estado gerado pelo mecanismo do Terraform em um espaço de trabalho do Schematics. O Schematics salva periodicamente o arquivo de estado nesse local seguro. Além disso, o arquivo de estado é restaurado automaticamente antes da execução dos trabalhos Schematics ou da execução de comandos do Terraform, como plan, apply, destroy, refresh, ou import.

Da mesma forma, o IBM Cloud Schematics oferece suporte ao armazenamento de arquivos definidos pelo usuário que são gerados pelo modelo ou pelos módulos do Terraform. O Schematics espera que o modelo ou os módulos do Terraform definidos pelo usuário gerem e coloquem os arquivos em um local predefinido. O Schematics os salva e restaura automaticamente antes e depois da execução das tarefas do Schematics ou do comando do Terraform.

Seus arquivos devem ser colocados na pasta /tmp/.schematics, e o limite está definido em 10 MB. O Schematics faz backup e restaura todos os arquivos da pasta /tmp/.schematics.

Como identificar a melhor maneira de sincronizar um recurso excluído com o estado do Terraform?

Atualmente, o serviço IBM Cloud Schematics não oferece suporte à importação ou sincronização do estado dos recursos na nuvem para o espaço de trabalho Schematics. Está planejado no roteiro futuro.

Como faço para resolver o problema de uma solicitação que excede a cota de recursos do cluster de “100” para a conta em qualquer região?

Error: Request failed with status code: 403, ServerErrorResponse: {"incidentID":"706efb2c-3461-4b9d-a52c-038fda3929ea,706efb2c-3461-4b9d-a52c-038fda3929ea","code":"E60b6","description":"This request exceeds the 'Cluster' resource quota of '100' for the account in this region. Your account already has '100' of the resource in the region, and the request would add '1'. Revise your request, remove any unnecessary resources, or contact IBM support to increase your quota.","type":"General"}

Você vê esse erro de validação de cota quando a cota de recursos do Cluster do 100 para a conta nesta região é excedida. Você pode considerar excluir os recursos existentes e tentar executar a operação novamente.

Ao criar recursos do tipo Red Hat OpenShift ou Kubernetes, posso aumentar o tempo limite de 90 minutos para um valor maior?

Sim, você pode aumentar o tempo limite para os recursos Red Hat OpenShift ou Kubernetes. Para obter mais informações, consulte ibm_container_vpc_cluster fornece as seguintes opções de configuração.

Como posso corrigir o erro 403 ao validar a localização na conta do catálogo global?

Você pode verificar a localização ou o acesso para criar ou visualizar o recurso nas configurações do catálogo da sua conta. Para obter mais informações, consulte Gerenciar configurações de local no catálogo global.

É possível iniciar ou parar o Virtual Servers for VPC com base nas sinalizações e por meio do planejador ou tarefa cron?

Sim, você pode usar o Cloud Functions para configurar operações gerenciadas, como iniciar e parar consultas com base em tags, e também por meio do agendador ou de uma tarefa cron para acionar a ação Schematics. Para obter mais informações, consulte o repositório GitHub da solução de operações e programação VSI.

Seria possível criar um nó de trabalho em um conjunto de nós de trabalho já existente?

Sim, você pode criar ou adicionar um nó de trabalho em um pool de nós de trabalho existente usando o recurso de pool de trabalho de contêiner IBM em um cluster Kubernetes por meio do Schematics. Ou Terraform usando IBM Recurso de anexo da zona de conexão do trabalhador de contêineres. Para obter mais informações, consulte ibm_container_worker_pool_zone_attachment.

Onde é possível visualizar a lista de endereços IP públicos e privados permitidos das regiões us-south, us-east, eu-gb e eu-de?

É possível visualizar a lista de endereços IP públicos e privados permitidos das regiões us-south, us-east, eu-gb e eu-de nos endereços IP permitidos do Schematics.

Posso incluir ou remover manualmente um recurso do painel de serviço diretamente?

Ao provisionar recursos com o IBM Cloud Schematics, o estado de seus recursos é armazenado em um arquivo de estado local do IBM Cloud Schematics. Este arquivo de estado é a única fonte de verdade para o IBM Cloud Schematics determinar quais recursos são provisionados em sua conta do IBM Cloud. Se você incluir manualmente um recurso sem o IBM Cloud Schematics, esse recurso não será armazenado no arquivo de estado do IBM Cloud Schematics e, como consequência, não poderá ser gerenciado com o IBM Cloud Schematics.

Quando você remove manualmente um recurso provisionado com o IBM Cloud Schematics, o arquivo de estado não é atualizado automaticamente e fica fora de sincronização. Ao criar seu próximo plano de execução do Terraform ou aplicar uma nova versão do modelo, o Schematics verifica se os recursos do Cloud no arquivo de estado existem na sua conta do IBM Cloud com o estado registrado nesse arquivo. Se o recurso não for encontrado, o arquivo de estado é atualizado e o plano de execução do Terraform é alterado.

Para manter seu arquivo de estado do IBM Cloud Schematics e os recursos da nuvem em sua conta sincronizados, use o IBM Cloud Schematics para provisionar ou remover seus recursos.

Que mudanças posso fazer em meus recursos?

Você pode optar por adicionar, modificar ou remover código de infraestrutura em seu modelo do Terraform por meio de GitHub, ou atualizar os valores das variáveis no painel de espaços de trabalho do Schematics.

Como posso comparar o estado necessário dos meus recursos em nuvem com o estado real dos meus recursos?

Para criar um relatório de desvio e visualizar as mudanças entre os serviços de infraestrutura e plataforma que você especificou em seus arquivos de configuração Terraform. Você pode usar planos de execução Terraform. Um plano de execução do Terraform resume quais ações do Schematics precisa tomar para provisionar o ambiente de nuvem que está descrito em seus arquivos de configuração do Terraform. Essas ações podem incluir adicionar, modificar ou remover recursos na nuvem.

Quais são os desvios que não podem ser detectados?

  • Um plano de execução do Terraform é baseado no Arquivo de estado do Terraform que é criado quando você executa a sua primeira ação de aplicação do Schematics.
  • Os recursos que você provisionou em outros espaços de trabalho do Schematics usando ferramentas de automação, como Ansible ou Chef, e que foram adicionados sem Schematics, não são incluídos no plano de execução do Terraform.

Como faço para remover recursos com o IBM Cloud Schematics?

Você pode usar o console do IBM Cloud Schematics ou a CLI para remover todos os recursos que provisionou com o Schematics. Para ficar em sincronize com o seu modelo Terraform, certifique-se de remover o código de infraestrutura associado do seu modelo Terraform. Para que seus recursos não sejam adicionados novamente quando você aplicar uma nova versão do seu modelo do Terraform.

O que acontece se eu optar por excluir meu recurso diretamente do painel de recursos?

Quando você remove manualmente um recurso provisionado com o IBM Cloud Schematics, o arquivo de estado não é atualizado automaticamente e fica fora de sincronização. Ao criar próximo plano de execução da Terraform, ou aplicar uma nova versão de template. O site Schematics verifica se os recursos da nuvem no arquivo de estado existem em sua conta IBM Cloud com o estado que foi capturado. Se o recurso não for encontrado, o arquivo de estado é atualizado e o plano de execução do Terraform é alterado.

Embora o arquivo de estado seja atualizado antes que novas alterações em seus recursos na nuvem sejam aplicadas, não remova manualmente recursos do painel de recursos para evitar resultados inesperados. Em vez disso, use o console ou a CLI do IBM Cloud Schematics para remover seus recursos ou remova o código de infraestrutura associado de seu modelo Terraform.

O site Schematics é compatível com o comando ibmcloud terraform?

Usando o comando ibmcloud terraform a partir do CLI release v1.8.0 exibe uma mensagem de aviso como Alias Terraform are deprecated. Use schematics or sch in your commands. Para obter mais informações, consulte Histórico da versão CLI.

Posso acessar uma rede privada por meio de Schematics?

Sim, a partir da Liberação da CLI v1.8.0, o Schematics suporta o terminal privado do Schematics para acessar sua rede privada. Para obter mais informações, consulte o ponto de extremidade privado Schematics.

Como posso resolver a mensagem de erro ao me conectar aos endereços IP do Bastion Host pelo IBM Cloud Schematics?

Erro

timeout - last error: Error connecting to bastion: dial tcp
 2022/03/02 03:59:37 Terraform apply | 52.118.101.204:22: connect: connection timed out
 2022/03/02 03:59:37 Terraform apply |
 2022/03/02 03:59:37 Terraform apply | Error: file provisioner error

Você pode acessar seus espaços de trabalho Schematics e se conectar a Bastion host IPs por região ou zona, usando endereços de endpoint públicos ou privados. Para obter mais informações, consulte Como abrir os endereços IP para o IBM Cloud Schematics em seu firewall.

Como criar um cluster usando o Terraform no ambiente IBM Cloud?

Consulte o tutorial de cluster Red Hat OpenShift on IBM Cloud de zona única e múltipla e Kubernetes Service.

É possível configurar o Terraform para usar sempre a versão atual ou a versão padrão?

Sim, no arquivo de payload ou JSON, se os valores dos parâmetros type e template_type não forem declarados em tempo de execução, será considerada a versão padrão do Terraform. Para obter mais informações, consulte especificando restrições de versão para o Terraform. É possível especificar a versão do Terraform na carga útil usando o parâmetro type ou template_type. No entanto, verifique se o valor da versão para o type e template_type contém a mesma versão.

Se eu definir type: = terraform_v1.4 no arquivo JSON, conforme mostrado no bloco de código, o Terraform version 1.4 continuará a ser usado mesmo que o Terraform version 2.0 ou versões superiores sejam lançadas?

    //Sample JSON file
    {
    "name": "<workspace_name>",
    "type": "terraform_v1.4",
    "resource_group": "<resource_group>",
    "location": "",
    "description": "<workspace_description>",
    "template_repo": {
    "url": "http://xxxxx.git",
    "branch": "main"
    },
    "template_data": [{
    "folder": "",
    "type": "terraform_v1.4"
    }]
    }

Não, se a versão do Terraform for especificada na carga útil ou no modelo, apenas a versão indicada em versions.tf será considerada durante o provisionamento. Para considerar a versão atual Terraform, é possível configurar o parâmetro required_version como required_version = ">=1.4 <2.0". Para obter mais informações, consulte restrições de versão para o Terraform.

Posso especificar apenas a versão do provedor no parâmetro “version”? Ou é obrigatório fornecer o parâmetro required_version no arquivo versions.tf?

Sim, é necessário especificar o version = "x.x.x" uma vez que ele significa a versão do provedor IBM Cloud. Considerando que required_version = ">1.4, <2.0" signifique a versão Terraform para provisão. Para obter mais informações, consulte restrições de versão para o Terraform. Se o parâmetro “version” não estiver declarado no arquivo versions.tf , a versão atual do plug-in do provedor será usada automaticamente em Schematics. Para obter mais informações, consulte restrições de versão para os provedores Terraform.

Qual é a diferença entre delete e destroy em Schematics?

Destruir excluir o recurso de nuvem associado da área de trabalho. A área de trabalho de exclusão é usada para excluir a área de trabalho. A recomendação é destruir o recurso primeiro do espaço de trabalho e, em seguida, definir a exclusão do espaço de trabalho. Para obter mais informações, consulte Excluindo uma área de trabalho

Posso deletar e destruir operação como um passo?

Não é possível excluir e destruir a operação em uma etapa. É necessário seguir o processo para destruir primeiro e depois excluir.

O que é um grupo de recursos e como ele me ajuda a organizar minha equipe?

Designar o acesso a um determinado serviço do IBM Cloud é uma boa maneira de permitir que um usuário trabalhe com um serviço específico em sua conta. No entanto, ao construir cargas de trabalho de produção na nuvem, muito provavelmente você tem vários serviços e recursos do IBM Cloud que são usados por diferentes equipes. Com os grupos de recursos, é possível organizar diversos serviços em sua conta e empacotá-los sob um processo de visualização e de faturamento comum. Para permitir que sua equipe trabalhe com esses recursos, é possível designar políticas de acesso do IAM a um grupo de recursos que permite que eles visualizem e gerenciem os recursos dentro de um grupo de recursos.

Por exemplo, você tem uma equipe A que é responsável por gerenciar um cluster do IBM Cloud Kubernetes Service e outra equipe B que desenvolve apps sem servidor com o IBM Cloud® Functions. Ambas as equipes utilizam os espaços de trabalho do IBM Cloud Schematics para gerenciar seus recursos na nuvem. Para ajudar a garantir o isolamento do espaço de trabalho e dos recursos, crie um grupo de recursos para cada equipe. Em seguida, você atribui as permissões necessárias a cada grupo de recursos. Por exemplo, a função de acesso “Gerente” tem acesso a todas as áreas de trabalho do grupo de recursos A, mas a função de acesso “Leitor” tem acesso às áreas de trabalho do grupo de recursos B.

Qual é a vantagem de usar um grupo de acesso do IAM?

Para reduzir o número de políticas de acesso ao IAM atribuídas a usuários individuais, é possível criar um grupo de acesso ao IAM para cada equipe e conceder ao grupo todas as permissões necessárias para trabalhar com os recursos em um grupo de recursos.

A imagem a seguir mostra como você pode usar grupos de acesso do IAM e grupos de recursos para organizar as permissões na sua conta do IBM Cloud.

<img src="../images/schematics-user-flow-rg.png" alt="Using resource groups and IAM access groups to organize access to IBM Cloud Schematics" width="900" style="width: 900px; border-style: none"/>
  1. O proprietário da conta ou um administrador autorizado define uma equipe e cria um grupo de acesso do IAM para cada equipe.
  2. O acesso a recursos dentro de um grupo de recursos específico é designado ao grupo de acesso do IAM. Por exemplo, o grupo de acesso A recebe permissões do editor para todos os recursos no grupo de recursos A, mas apenas permissões de visualizador para os recursos no grupo de recursos B.
  3. O proprietário da conta ou um administrador autorizado inclui usuários no grupo de acesso do IAM. Todos os usuários herdam automaticamente as permissões do grupo de acesso do IAM.

Quais são as etapas para criar e restringir os tokens de acesso pessoal (PAT) clássicos e refinados?

Para iniciar a API GitHub e estabelecer conexões Git por HTTPs e criar scripts rápidos e testar integrações, são usados os PATs. Para obter mais informações, consulte sobre o PAT

GitHub atualmente, o sistema suporta dois tipos de tokens de acesso pessoal, e os proprietários da organização podem definir uma política para restringir o acesso de tokens de acesso pessoal à sua organização:

  • tokens de acesso pessoal de baixa granularidade
  • tokens de acesso pessoal (clássico). GitHub recomenda que você use tokens de acesso pessoal de baixa granularidade em vez de tokens de acesso pessoal (clássico) sempre que possível.

A seguir estão as etapas para criar e restringir os tokens de PAT.

Posso executar a opção terraform init -backend-config="KEY=VALUE" por meio da CLI?

Schematics não oferece suporte à capacidade de editar a configuração do backend do Terraform. O site Schematics gerencia internamente o arquivo de estado, em seu próprio bucket IBM Cloud Object Storage, que é criptografado usando a criptografia envelop.

Quando você especifica a ramificação principal ou do subdiretório GitHub ?

Criação da área de trabalho

Na página de criação da área de trabalho, para o Repository URL O link pode ter como destino a ramificação master, outras ramificações ou um subdiretório. Na página “Configurações” do espaço de trabalho, clique no ícone de edição para editar seu Repository URL. Para obter mais detalhes sobre a criação da área de trabalho, consulte Criando uma área de trabalho O link pode ter como destino a ramificação master, outras ramificações ou um subdiretório. - Exemplo para o ramo “ master ”: https://github.com/myorg/myrepo - Exemplo para outros ramos: https://github.com/myorg/myrepo/tree/mybranch - Exemplo de subdiretório: https://github.com/mnorg/myrepo/tree/mybranch/mysubdirectory

O nome da filial que contém / (barra invertida) não é compatível.

Criação de ação

Na página de criação da ação, o URL pode apontar para o branch mestre, qualquer outro branch ou um subdiretório. Se o seu repositório contiver vários playbooks, selecione o playbook que você deseja executar. Uma ação do Schematics pode apontar para um playbook de cada vez. Para obter mais detalhes sobre como trabalhar com uma ação, consulte Criação de uma ação para executar vários manuais, é necessário criar uma ação separada para cada manual. - Exemplo para o branch master - https://github.com/myorg/myrepo - Exemplo para outras filiais - https://github.com/myorg/myrepo/tree/mybranch - Exemplo de subdiretório - https://github.com/mnorg/myrepo/tree/mybranch/mysubdirectory

Não tem um playbook que você possa usar? Experimente um de seus playbooks de amostra

Na página “Configurações” do espaço de trabalho, clique no ícone de edição para editar seu Repository URL. O link pode ter como destino a ramificação master, outras ramificações ou um subdiretório. - Exemplo para o ramo “ master ”: https://github.com/myorg/myrepo - Exemplo para outros ramos: https://github.com/myorg/myrepo/tree/mybranch - Exemplo de subdiretório: https://github.com/mnorg/myrepo/tree/mybranch/mysubdirectory

É possível configurar a atividade da chamada API do Schematics ?

O plug-in Schematics permite que você configure o tempo limite para 30 seconds para as chamadas de API Schematics por meio do ibmcloud config --http-timeout flag. Por exemplo, ibmcloud config --http-timeout=30. O valor padrão das solicitações HTTP é 60 seconds.

O site Schematics oferece suporte ao acesso baseado em região?

Sim, o Schematics suporta acesso baseado em região. Para obter mais informações, consulte Acesso baseado em região e as etapas para configurar o acesso baseado em região para convidar um usuário.

O Workspace and Action é compatível com o site Secrets Manager?

Sim, o Workspace e o Action oferecem suporte Secrets Manager quando você cria um workspace e atualiza a variável de entrada workspace. Além disso, você pode definir o endereço Secrets Manager ao criar um playbook e editar as configurações de ação.

Você pode inserir o token de acesso pessoal ou usar Secrets Manager usando Open reference picker para selecionar sua referência de chave Secrets Manager. Para obter mais informações, consulte a criação de uma instância do Secrets Manager. O valor da chave do Secrets Manager é usado durante o tempo de execução para clonar os modelos do repositório Git.

Por que os comandos eval e uname estão sendo restringidos?

O comando eval pode introduzir vulnerabilidades de segurança, como riscos de injeção de código, enquanto o comando uname pode expor informações do sistema que os invasores exploram.

As restrições ajudam a manter um ambiente de execução seguro em Schematics.

Como as restrições dos comandos eval e uname afetam os scripts e a automação existentes?

Se seus scripts ou fluxos de trabalho de automação dependerem do comando uname, ele falhará após 16 de abril de 2025. Para o comando eval, Schematics permite a execução de operações de avaliação seguras. A execução de comandos em nível de sistema operacional por meio do comando eval em scripts ou fluxos de automação é restrita. Você precisa modificar seus scripts para remover ou substituir esses comandos por métodos alternativos.

Quais soluções alternativas podem substituir os comandos eval e uname ?

Em vez de eval, o comando considera o uso de alternativas mais seguras, como instruções condicionais, substituição de parâmetros ou métodos de execução de comandos incorporados. Em vez disso, o uname usa variáveis de ambiente predefinidas ou serviços de metadados do sistema fornecidos pelo IBM Cloud para recuperar as informações necessárias do sistema. Se tiver dúvidas, comentários ou preocupações, sempre poderá entrar em contato com a equipe por meio do suporte IBM Cloud®.

Exemplo usando o comando eval

command="ls -l /home/user"
eval $command

Exemplo sem o comando eval

command="ls -l /home/user"
$command

A alteração dos comandos eval e uname afeta a execução do Terraform em Schematics?

A execução do Terraform não tem um impacto direto, a menos que seus scripts ou módulos usem explicitamente comandos como eval ou uname. Se for usado explicitamente, será necessário modificar.

Quais são os pontos de extremidade compatíveis com Schematics?

Atualmente, o site Schematics é compatível apenas com os pontos de extremidade de serviço clássicos (CSE) disponíveis nos tipos public e private. Se você tentar usar os clusters update, modify, ou manage IBM Cloud Kubernetes Service ou Red Hat OpenShift, precisará usar o CSE public ou private.

Você pode definir o valor cluster_config_endpoint_type como private na configuração. Para obter mais informações, consulte Argumentos do ponto de extremidade.

data "ibm_container_cluster_config" "cluster_foo" {
cluster_name_id = "FOO"
config_dir = "/home/foo_config"
admint = "true"
endpoint_type = "private"
}

Atualmente, o site Schematics não oferece suporte ao Virtual Private Endpoint (VPE). Se você selecionar a variável endpoint_type como vpe, os trabalhos Schematics falharão. Como alternativa, você precisa implantar os agentes Schematics em clusters IBM Cloud Kubernetes Service ou Red Hat OpenShift e executar trabalhos ou tarefas Schematics usando o VPE. Para obter mais informações, consulte Schematics Agents.