Criando uma Tarefa
Crie uma tarefa de runbook para executar operações de ciclo de vida em uma frota no Fleet Application Management.
As tarefas que você cria usando este procedimento são tarefas compartilhadas e podem ser usadas por qualquer manual.
- Na página de lista Tarefas, selecione Criar tarefa. Se precisar de ajuda para localizar a página da lista, consulte Listando Tarefas de Runbook.
-
Na página Criar tarefa, especifique as seguintes informações:
- Nome: Informe um nome exclusivo para a tarefa. Não é necessário que o nome seja exclusivo, mas não pode ser alterado na Console. No entanto, você pode alterá-lo com a API. Evite digitar informações confidenciais.
- Descrição: Informe uma descrição adequada para a tarefa.
- Criar no compartimento: Selecione o compartimento para o qual deseja criar a tarefa de manual.
- Compartimento da operação do ciclo de vida: Selecione um compartimento no qual exista a operação do ciclo de vida específica. Para saber mais sobre várias operações do ciclo de vida, consulte Operação do Ciclo de Vida no Fleet Application Management.
- Operação de ciclo de vida: Selecione uma operação de ciclo de vida — por exemplo, patch, descoberta, provisionamento ou qualquer outra operação personalizada.
- Para operações de ciclo de vida de patch ou descoberta, especifique as seguintes informações:
- Compartimento da pilha de Produtos/Produtos: Selecione o compartimento no qual a pilha de produtos ou produtos está.
- Pilha de Produtos/Produtos: Selecione no compartimento uma pilha de produtos ou produtos à qual a tarefa pertence.
- Tipo de ação: Selecione uma das seguintes opções:
- Executar um script: Anexe um script do Object Storage ou adicione seu script em linha em Comando. Para adicionar script em linha, consulte a subetapa n.
- Executar um terraform: Use um pacote Terraform para provisionar recursos. Etapa 4.
-
Se você tiver selecionado Executar um script, insira as seguintes informações em Detalhes do script, conforme necessário.
- Para tipo de SO, selecione uma plataforma suportada na qual a tarefa é executada.
-
Se a tarefa for destinada à descoberta de alvos:
- Ative a opção Marcar como tarefa de saída de descoberta. Esta ação permite que o Fleet Application Management colete informações de inventário de software da tarefa após ela ser concluída.
- Em Adicionar script, selecione Fazer download do modelo de saída de descoberta para garantir que a saída da tarefa corresponda ao formato do modelo de descoberta. Use o modelo de descoberta baixado como um guia para codificar o script de descoberta. Para saber mais sobre os atributos do modelo, consulte Sobre o Modelo de Saída de Descoberta.Observação
O sucesso da execução de scripts de descoberta ou de aplicação de patches depende dos comandos usados pelo gravador de scripts e se esses comandos são suportados na sua instância. Se alguns comandos falharem, configure o host com as instalações necessárias antes de usar os comandos. Por exemplo, usando comandos comomlocate
oulocate
para localizar arquivos.
- Se a tarefa for aplicar patches, ative a opção Esta tarefa precisa de patches para executar. Quando ativado, o Fleet Application Management preenche os detalhes dos patches recomendados para a tarefa. Os detalhes estão disponíveis no arquivo patches.json. O script pode ler o arquivo patches.json para obter todos os patches e usar a variável de ambiente, DATA_DIR, para saber o local do patch baixado pelo Fleet Application Management na instância do serviço Compute.
-
Para adicionar seu script para execução de tarefa, selecione uma das seguintes opções:
- Fazer upload ou selecionar em um armazenamento de Objetos: Uma opção para fazer upload do script do sistema de arquivos ou do bucket do Object Storage. Ir para a subetapa e.
- Selecionar do catálogo: Uma opção para escolher o script do item do catálogo privado. Ir para subetapa i.
-
Se a adição de script for por meio do serviço Object Storage, selecione Procurar ao lado de Selecionar script do serviço Object Storage.
Na página Selecionar arquivo, selecione uma das seguintes opções:
- Selecionar em um bucket de armazenamento de objetos: Selecione um script do serviço Object Storage, se ele já tiver sido submetido a upload e passe para a subetapa f.
- Fazer upload de um arquivo: Selecione um script fazendo upload dele para o Object Storage e pule para a subetapa g.
-
Se você tiver selecionado Selecionar em um bucket de armazenamento de objetos:
- Selecione o compartimento que contém o bucket do Object Storage com o script e, em seguida, selecione o bucket.
- Selecione um arquivo de script no bucket e selecione Selecionar. Ir para subetapa h.
-
Se você selecionou Fazer upload de um arquivo:
- Arraste um arquivo do sistema de arquivos para a caixa Arrastar e soltar ou procure o arquivo.
- Selecione o compartimento que contém o bucket do Object Storage para o qual você deseja fazer upload do arquivo e, em seguida, selecione o bucket.
- Selecione o arquivo do script conforme necessário.
- Para Prefixo de nome de objeto, especifique um prefixo para o arquivo que você faz upload para identificá-lo facilmente ao selecionar no serviço Object Storage.
- Selecione Fazer Upload e Selecionar para armazenar o script no bucket e selecionar o script para a tarefa.
- Alterne a opção Salvar como um item de catálogo para que o script seja armazenado como um item de catálogo. Em seguida, especifique o nome do item de catálogo armazenado.
- Se a adição do script for por meio do catálogo privado na subetapa d, selecione o compartimento que contém o item do catálogo e, em seguida, selecione o item do catálogo ou use o comando em linha. Para uso do comando, consulte a subetapa n.
- Ative a alternância Tornar o script executável para ativar a execução automática do arquivo de script.
- Ative a alternância Bloquear script para impedir a execução do script quando atualizado no bucket do Object Storage.
-
Ative a opção Adicionar variáveis de entrada se a tarefa exigir variáveis de entrada e informe os seguintes detalhes:
- Informe um nome exclusivo e a descrição para a variável. Evite digitar informações confidenciais.
- Para Tipo, selecione a variável de string ou de saída. Por exemplo, selecione o tipo como variável de saída se quiser que o valor da variável seja usado como uma variável de entrada para outra tarefa.
Adicione mais variáveis de entrada conforme necessário.
- Alterne a opção Adicionar variáveis de saída se a tarefa gerar variáveis de saída. Em seguida, informe um nome exclusivo para a variável. Adicione mais variáveis de saída conforme necessário.
- (Opcional) Se a execução da tarefa se basear em vários arquivos, na caixa Comando, forneça o comando para iniciar a execução. Forneça o comando para informar ao Fleet Application Management sobre como executar o script. O script pode ser um arquivo ZIP, um arquivo JAR, um arquivo EXE ou qualquer outro programa que possa ser executado na instância. As variáveis definidas para a tarefa podem ser passadas para o script como argumentos de local ou argumentos de valor-chave. Ao especificar uma variável como argumento, coloque "$" como prefixo. Por exemplo, para usar os arquivos ZIP e JAR:
- Digite o comando
unzip zippedfile.zip
para descompactar o arquivo que contém todos os arquivos e, em seguida, digite o comando./main.sh
para iniciar a execução. - Para passar variáveis para o comando, forneça-as como argumentos de linha de comando. Consulte os seguintes tipos de argumentos de linha de comando. Consulte os seguintes tipos de argumentos de linha de comando:
- Para argumentos estáticos, forneça-os diretamente como argumentos (por exemplo, se o script de tarefa esperar um valor de timeout), o argumento pode ser o seguinte:
./main.sh 10s
- Para argumentos dinâmicos baseados nos configurados na tarefa (por exemplo, se esperar timeout e backuptype), o argumento pode ser o seguinte:
./main.sh $timeout $backuptype
- Para uma combinação de argumentos estáticos e dinâmicos, o argumento pode ser o seguinte:
./main.sh 10s $backuptype
- Para argumentos estáticos, forneça-os diretamente como argumentos (por exemplo, se o script de tarefa esperar um valor de timeout), o argumento pode ser o seguinte:
- Informe o seguinte comando JAR para argumentos dinâmicos (backuptype e timeout):
java -jar ApplicationBackup.jar $backuptype $timeout
- Digite o comando
- (Opcional) Selecione um compartimento de credenciais e nomes de credenciais que você criou no serviço Vault se não estiver definido para o produto ou a pilha de produtos.
Importante
Se a tarefa exigir uma credencial, você deverá criá-la sob gerenciamento de metadados e fornecer seus detalhes para uma frota, recurso ou credencial de destino. Em seguida, o Fleet Application Management informa esses detalhes para a execução da tarefa do runbook.
-
Se você tiver selecionado Executar um terraform na etapa 2, digite as informações a seguir em Detalhes do Terraform, conforme necessário.
- Selecione um item de catálogo existente do Marketplace ou privado do Terraform no compartimento específico.
-
Se você tiver selecionado um pacote existente da Zona de Destino do Marketplace (OCI Core) de um compartimento específico na subetapa a, crie um item de catálogo privado para o tipo "pacote Terraform" para criar um pacote Terraform personalizado.
- Crie um item de catálogo privado do tipo de pacote CONFIG_FILE que contenha um exemplo de
config.json
. - Faça upload do
config.json
para um bucket do serviço Object Storage e crie um link de URL da PAR para ele. - Para Selecionar arquivo de configuração no catálogo, selecione o item correspondente do catálogo de pacotes do Terraform que contém o link do URL da PAR para o arquivo
config.json
, conforme mencionado na etapa anterior.Veja a seguir um arquivo de amostra
config.json
:{ "service_label": "cisbasic", "network_admin_email_endpoints": ["email.address@example.com"], "security_admin_email_endpoints": ["email.address@example.com"], "enable_cloud_guard": true }
Para obter informações sobre todas as variáveis de configuração do item de catálogo da Zona de Destino do OCI Core, consulte Variáveis da Zona de Destino do OCI Core.
- Crie um item de catálogo privado do tipo de pacote CONFIG_FILE que contenha um exemplo de
- Se você tiver selecionado um item de catálogo privado de configuração existente de um compartimento específico na subetapa a, crie um item de catálogo privado para o tipo "pacote Terraform" para criar um pacote de configuração personalizado.
-
Selecione um compartimento de destino no qual as instâncias do serviço Compute, os recursos do banco de dados, os volumes em blocos ou os recursos de rede criados após a execução do pacote Terraform possam residir.
Observação
A alocação de diferentes compartimentos para diferentes recursos torna os recursos mais seguros, gerenciáveis e escaláveis. - Ative a alternância Ler variável de saída para permitir que as variáveis de saída geradas pela execução do Terraform sejam lidas e usadas como entrada para a próxima tarefa.
-
Em Propriedades da tarefa, informe os seguintes detalhes:
- Máximo de novas tentativas em caso de falha: Especifique um valor para o número de vezes que uma tarefa deve repetir quando falhar.
- Timeout: Especifique um valor de timeout para uma tarefa em segundos quando ela falhar.
Consulte Propriedades da Tarefa.
- Para criar uma cópia da tarefa na biblioteca de tarefas, ative Fazer uma cópia dessa tarefa na biblioteca. Essa tarefa faz parte da biblioteca de tarefas e você pode reutilizar e atualizar essa tarefa da biblioteca.
- Selecione Criar.
Use o comando oci fleet-apps-management fleet-apps-management-runbooks task-record create e os parâmetros obrigatórios para criar uma tarefa de runbook:
oci fleet-apps-management fleet-apps-management-runbooks task-record create --compartment-id <compartment_OCID> --details <json_file_or_string> -display-name <text> [OPTIONS]
Para obter uma lista completa de flags e opções de variáveis para comandos da CLI do Fleet Application Management, consulte a CLI para Gerenciamento de Aplicativos de Frota.
Execute a operação CreateTaskRecord para criar uma tarefa de runbook.