Introdução ao IBM Cloud Shell

Neste tutorial de introdução, você usa IBM® Cloud Shell para clonar um aplicativo Node.js de amostra. IBM Cloud Shell é um espaço de trabalho de shell baseado em nuvem que você pode acessar pelo navegador. Cloud Shell é pré-configurado com a CLI completa IBM Cloud e vários plug-ins e ferramentas que você pode usar para gerenciar aplicativos, recursos e infraestrutura.

Novo no Cloud Shell? Assista ao vídeo de demonstração para ver como você pode começar a usar o serviço a partir do console IBM Cloud.

Antes de Iniciar

Se você ainda não tem uma conta no site IBM Cloud, inscreva-se em uma e faça login.
Observe as informações de acesso de conta a seguir que podem afetar o seu acesso ao Cloud Shell e os recursos dele:
- Um administrador de conta pode conceder aos usuários específicos acesso ao Cloud Shell e seus recursos, mesmo que as configurações do Cloud Shell estejam desativadas no nível de conta. Para obter mais informações, consulte Designando acesso ao Cloud Shell e seus recursos em um nível do usuário.
- Os proprietários da contas ou usuários com o acesso de administrador do Cloud Shell podem ativar ou desativar os recursos do Cloud Shell para uma conta. Os recursos disponíveis nesta liberação são Upload e download de arquivo e Visualização da web. As configurações do recurso aplicam-se apenas aos locais ativados do Cloud Shell. Para obter mais informações, consulte Ativando ou desativando recursos do Cloud Shell para uma conta.
- Para obter mais informações, consulte Funções e ações do IAM.

Iniciar uma sessão no IBM Cloud Shell

No console do IBM Cloud, clique no ícone IBM Cloud Shell . Uma sessão inicia e efetua o seu login automaticamente por meio da CLI do IBM Cloud.

Clonar o app Node.js de amostra

Sua sessão do Cloud Shell inicia no diretório inicial temporário, /home/<user-name>. Clone o aplicativo de amostra Node.js Express para esse diretório e, em seguida, mude para o diretório do aplicativo de amostra executando os seguintes comandos.

git clone https://github.com/IBM/nodejs-express-app.git

cd nodejs-express-app

No seu diretório de app, execute o comando a seguir para visualizar os novos arquivos.

ls

É possível ver que o seu diretório nodejs-express-app contém todos os arquivos e pastas do app de amostra.

Dockerfile  Dockerfile-tools  LICENSE  README.md  package-lock.json
package.json  public  scripts  server  test

Visualizar o app localmente

É possível iniciá-lo no Cloud Shell e visualiza-lo localmente.

Primeiro, faça download das dependências do projeto do app de amostra Node.js.
```
npm install --only=prod
```

Inicie o app.

npm run start

Quando o app estiver em execução, será exibido o local no qual a IU do app está disponível. Para Cloud Shell, você precisa observar apenas a porta, que, nesse caso, é 3000.

> nodejsexpressapp@1.0.0 start /home/my-user-name/nodejs-express-app
> node server/server.js

App UI available http://localhost:3000
Swagger UI available http://localhost:3000/swagger/api-docs

Na barra de menus do Cloud Shell, clique no ícone Visualização da Web e selecione a porta 3000.

A visualização do app é aberta em uma nova janela. Se você vir a mensagem de parabéns, seu app estará sendo executado localmente no Cloud Shell.
Pressione Control+C para parar o aplicativo..

Próximas etapas

No Cloud Shell, é possível executar comandos rapidamente em sua conta do IBM Cloud. Por exemplo:

Além da CLI do IBM Cloud, o Cloud Shell é pré-configurado com todos os plug-ins da CLI do IBM Cloud e muitas ferramentas e tempos de execução para ajudar você a trabalhar na nuvem. Para obter a lista completa, consulte Plug-ins e ferramentas instalados.