Skip to main content
Workload Factory for NetApp Console
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Use o CloudShell na NetApp Workload Factory

Colaboradores netapp-rlithman
PDFs

Abra CloudShell para executar comandos da CLI da AWS ou do ONTAP de qualquer lugar no console do NetApp Workload Factory.

Sobre esta tarefa

O CloudShell permite executar comandos da AWS CLI ou da ONTAP CLI em um ambiente semelhante a um shell, diretamente do console do Workload Factory. Ele simula sessões de terminal no navegador, fornecendo recursos de terminal e usando proxy para mensagens pelo backend do Workload Factory. Ele permite que você use as credenciais da AWS e da ONTAP que você forneceu em sua conta NetApp.

CloudShell inclui os seguintes recursos:

  • Múltiplas sessões do CloudShell: implante várias sessões do CloudShell de uma só vez para executar várias sequências de comandos em paralelo,

  • Visualizações múltiplas: divida sessões de abas do CloudShell para que você possa visualizar duas ou mais abas horizontalmente ou verticalmente ao mesmo tempo

  • Renomear sessões: renomeie as sessões conforme necessário

  • Persistência do conteúdo da última sessão: reabra a última sessão caso a tenha fechado por engano

  • Preferências de configurações: altere o tamanho da fonte e o tipo de saída

  • Respostas de erro geradas por IA para comandos da CLI do ONTAP

  • Suporte para autocompletar: comece a digitar um comando e use a tecla Tab para visualizar as opções disponíveis

Observação Se o administrador da sua conta desativou os recursos de IA, as respostas de erro geradas por IA não estarão disponíveis. "Saiba mais sobre como gerenciar recursos de IA".

CloudShell comandos

Na interface gráfica do CloudShell, você pode inserir help para visualizar os comandos disponíveis do CloudShell. Depois de executar o comando help, a referência a seguir aparece.

Descrição

O NetApp CloudShell é uma interface GUI incorporada ao NetApp Workload Factory que permite que você execute comandos da AWS CLI ou da ONTAP CLI em um ambiente semelhante a um shell. Ele simula sessões de terminal no navegador, fornecendo recursos de terminal e usando proxy para mensagens por meio do back-end no Workload Factory. Ele permite que você use as credenciais da AWS e as credenciais do ONTAP que você forneceu na sua conta NetApp.

Comandos disponíveis

  • clear

  • help

  • [--fsx <fsxId>] <ontap-command> [parameters]

  • aws <aws-command> <aws-sub-command> [parameters]

Contexto

Cada sessão de terminal é executada em um contexto específico: credenciais, região e, opcionalmente, o sistema de arquivos FSx for ONTAP.

+ Todos os comandos da AWS são executados no contexto fornecido. Os comandos da AWS só serão bem-sucedidos se as credenciais fornecidas tiverem permissões na região especificada.

+ Você pode especificar comandos ONTAP com um opcional fsxId. Se você fornecer um fsxId com um comando ONTAP individual, esse ID substituirá o ID no contexto. Se a sessão do terminal não tiver um contexto de ID do sistema de arquivos do FSx for ONTAP, você deverá fornecer fsxId com cada comando ONTAP.

+ Para atualizar diferentes especificidades de contexto, faça o seguinte: * Para alterar as credenciais: "using credentials <credentialId>" * Para alterar a região: "using region <regionCode>" * Para alterar o sistema de arquivos FSx for ONTAP: "using fsx <fileSystemId>"

Exibindo itens

  • Para exibir as credenciais disponíveis: "show credentials"

  • Para exibir as regiões disponíveis: "show regions"

  • Para exibir o histórico de comandos: "show history"

Variáveis

A seguir, apresentamos exemplos de como definir e usar variáveis. Se o valor de uma variável contiver espaços, você deverá defini-lo entre aspas.

+ * Para definir uma variável: $<variable> = <value> * Para usar uma variável: $<variable> * Exemplo de definição de uma variável: $svm1 = svm123 * Exemplo de uso de uma variável: --fsx FileSystem-1 volumes show --vserver $svm1 * Exemplo de definição de uma variável com valor de string $comment1 = "Um comentário com espaços"

Operadores

Operadores do shell, como pipe |, execução em segundo plano & e redirecionamento > não são suportados. A execução de comandos falha se você incluir esses operadores.

Antes de começar

CloudShell funciona no contexto das suas credenciais da AWS. Para usar CloudShell, você precisa fornecer pelo menos uma credencial da AWS.

Observação O CloudShell está disponível para você executar qualquer comando da CLI da AWS ou do ONTAP. No entanto, se você quiser trabalhar no contexto de um sistema de arquivos FSx for ONTAP, certifique-se de executar o seguinte comando: using fsx <file-system-name>.

Implante o CloudShell

Você pode implantar CloudShell de qualquer lugar no console do NetApp Workload Factory. Você também pode implantar CloudShell a partir do NetApp Console.

Implantar a partir do console do Workload Factory
Passos

  1. Faça login no "NetApp Console".

  2. No menu NetApp Console, selecione Cargas de trabalho > Administração > CloudShell.

  3. Na janela do CloudShell, selecione as credenciais e a região para a sessão do CloudShell e, em seguida, selecione a seta para continuar.

    Captura de tela que mostra uma nova sessão do CloudShell.

  4. Digite help para visualizar os comandos disponíveis CloudShell comandos e as instruções ou consulte os seguintes documentos de referência da CLI para obter informações sobre os comandos disponíveis:

  5. Emita comandos na sessão do CloudShell.

    Se ocorrer um erro após executar um comando da CLI do ONTAP, selecione o ícone de lâmpada para obter uma breve resposta de erro gerada por IA com uma descrição da falha, a causa da falha e uma resolução detalhada. Selecione Leia mais para obter mais detalhes.

Implantar a partir do NetApp Console
Passos

  1. Faça login no "NetApp Console".

  2. No menu NetApp Console, selecione Cargas de trabalho > Administração > CloudShell.

  3. Na janela do CloudShell, selecione as credenciais e a região para a sessão do CloudShell e, em seguida, selecione a seta para continuar.

    Captura de tela que mostra uma nova sessão do CloudShell.

  4. Pressione Enter help para ver os comandos e as instruções disponíveis do CloudShell ou consulte os seguintes documentos de referência da CLI para ver os comandos disponíveis:

  5. Emita comandos na sessão do CloudShell.

    Se ocorrer um erro após executar um comando da CLI do ONTAP, selecione o ícone de lâmpada para obter uma breve resposta de erro gerada por IA com uma descrição da falha, a causa da falha e uma resolução detalhada. Selecione Leia mais para obter mais detalhes.

As tarefas do CloudShell mostradas nesta captura de tela podem ser concluídas selecionando o menu de ações de uma guia de sessão aberta do CloudShell. As instruções para cada uma dessas tarefas seguem abaixo.

Captura de tela que mostra o menu de ações da guia CloudShell com opções como renomear, duplicar, fechar outras guias e fechar todas.

Renomear uma aba de sessão do CloudShell

Você pode renomear uma aba de sessão do CloudShell para ajudar você a identificar a sessão.

Passos

  1. Selecione o menu de ações da guia de sessão do CloudShell.

  2. Selecione Renomear.

  3. Digite um novo nome para a guia da sessão e, em seguida, clique fora do nome da guia para definir o novo nome.

Resultado

O novo nome aparece na guia de sessão do CloudShell.

Guia de sessão duplicada do CloudShell

Você pode duplicar uma guia de sessão do CloudShell para criar uma nova sessão com o mesmo nome, credenciais e região. O código da guia original não é duplicado na guia duplicada.

Passos

  1. Selecione o menu de ações da guia de sessão do CloudShell.

  2. Selecione Duplicar.

Resultado

A nova aba aparece com o mesmo nome da aba original.

Fechar abas da sessão do CloudShell

Você pode fechar as abas do CloudShell uma de cada vez, fechar as outras abas em que você não está trabalhando ou fechar todas as abas de uma só vez.

Passos

  1. Selecione o menu de ações da guia de sessão do CloudShell.

  2. Selecione uma das seguintes opções:

    • Selecione "X" na janela da guia CloudShell para fechar uma aba de cada vez.

    • Selecione Fechar outras abas para fechar todas as outras abas abertas, exceto aquela em que você está trabalhando.

    • Selecione Close all tabs para fechar todas as abas.

Resultado

As abas da sessão selecionada do CloudShell serão fechadas.

Dividir no CloudShell as abas de sessão

Você pode dividir as abas da sessão do CloudShell para visualizar duas ou mais abas ao mesmo tempo.

Etapa

Arraste e solte as abas da sessão do CloudShell na parte superior, inferior, esquerda ou direita da janela do CloudShell para dividir a visualização.

Captura de tela que mostra duas abas do CloudShell divididas horizontalmente. As abas aparecem lado a lado.

Atualizar configurações para uma sessão CloudShell

Você pode atualizar as configurações de fonte e tipo de saída para as sessões do CloudShell.

Passos

  1. Implante uma sessão do CloudShell.

  2. Na aba CloudShell, selecione o ícone de configurações.

    A caixa de diálogo de configurações aparece.

  3. Atualize o tamanho da fonte e o tipo de saída conforme necessário.

    Observação A saída enriquecida aplica-se a objetos JSON e à formatação de tabelas. Toda a outra saída aparece como texto simples.

  4. Selecione Aplicar.

Resultado

As configurações do CloudShell foram atualizadas.