Pré-instalando o Kit de Desenvolvimento do Oracle Cloud
Provisione uma instância de computação com o Oracle Cloud Development Kit pré-instalado e pronto para uso.
O que está incluído
O modelo do Oracle Cloud Development Kit pré-instala os seguintes itens do Oracle Cloud Infrastructure na instância do Compute:
- Interface de Linha de Comando (CLI)
- Provedor Terraform
- Ansible (inclui módulos Ansible do OCI)
- Os seguintes SDKs:
- Git: Use a ferramenta de linha de comando Git fornecida para acessar qualquer sistema de controle de versão relacionado ao Git, como Bitbucket, GitHub e GitLab.
A autorização do controlador de instâncias é configurada para itens instalados e a instância do serviço Compute provisionada. Um script de atualização também está incluído.
Etapas para Usar o Kit de Desenvolvimento do Oracle Cloud
Para provisionar uma instância com o kit de desenvolvimento
-
Inicie a página Criar pilha para o modelo do Oracle Cloud Development Kit selecionando este botão:
Etapas alternativas da Console- Na página da lista Pilhas, selecione Criar pilha. Se precisar de ajuda para localizar a página da lista ou a pilha, consulte Listando Pilhas.
- Na página Criar pilha, selecione Modelo.
- Em Configuração da pilha, selecione Selecionar modelo.
- No painel Procurar modelos, selecione Arquitetura.
- Selecione Kit de desenvolvimento do Oracle Cloud.Observação
Talvez seja necessário ir para sua região home antes que o modelo esteja disponível para seleção.O foco muda de volta para a página Criar pilha e o modelo do Oracle Cloud Development Kit é selecionado.
-
Siga os prompts para salvar sua nova pilha e provisionar a instância
- Na página Criar pilha, digite um Nome para a nova pilha (ou aceite o nome padrão fornecido). Evite digitar informações confidenciais.
- Como alternativa, digite uma Descrição.
-
No menu suspenso Criar no compartimento, selecione o compartimento no qual deseja criar a pilha.
Um compartimento do escopo da lista é definido por padrão.
Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deverá ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore esta opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.
-
Selecione Próximo.
O painel Configurar variáveis exibe as seguintes variáveis:
- Forma da Instância: Selecione a forma que você deseja usar para a instância do serviço Compute.
- Gerar automaticamente par de chaves SSH: gera um par de chaves SSH ou permite fazer upload de uma chave pública.
- Ativado (selecionado): Gera automaticamente um par de chaves SSH para acessar a instância. A chave privada é armazenada no arquivo de estado do Terraform. Você usará a chave privada posteriormente para estabelecer conexão com a instância.Importante
Não use essa opção na produção. O arquivo de estado do Terraform que contém a chave privada fica visível para qualquer pessoa com acesso à pilha criada. - Desativado (limpo): permite fazer upload de uma chave pública. Nenhuma chave privada é armazenada. Mantenha a chave privada correspondente em um local seguro. Você usará a chave privada posteriormente para estabelecer conexão com a instância.
Para obter instruções sobre a geração de pares de chaves SSH, consulte Managing Key Pairs on Linux Instances.
- Ativado (selecionado): Gera automaticamente um par de chaves SSH para acessar a instância. A chave privada é armazenada no arquivo de estado do Terraform. Você usará a chave privada posteriormente para estabelecer conexão com a instância.
- Instância de computação para acessar todos os recursos no nível da tenancy: controla o nível usado para a política de grupo dinâmico, que determina quais recursos são acessíveis pelos usuários da instância de Computação.
- Ativado (selecionado): Nível da tenancy para acesso a todos os recursos na tenancy.
- Desativado (limpo): Nível de compartimento para acesso a todos os recursos no mesmo compartimento da instância.
-
Selecione Próximo.
-
No painel Revisão , verifique a configuração da pilha.
-
Marque a caixa de seleção Executar aplicação.
Essa opção provisiona automaticamente a instância na criação da pilha.
-
Selecione Criar para criar sua pilha e provisionar automaticamente a instância.
A nova pilha é exibida na página Detalhes da Pilha. O Resource Manager executa a ação Aplicar na nova pilha, iniciando o processo para provisionar a instância.
O novo job de aplicação é listado em Jobs. Monitore seu status: "Bem-sucedido" indica que o job foi concluído. Enquanto o job é executado ou após seu término, você pode fazer download do arquivo de log.
Depois que a instância é provisionada (indicada por um status "Bem-sucedido" para o job de aplicação), a instalação dos itens do kit de desenvolvimento começa. O processo de instalação leva alguns minutos. Se você estabelecer conexão com a instância antes do término da instalação, uma mensagem de aviso indicará que a instalação ainda está em andamento. Depois que os itens forem instalados na instância, você poderá usá-los imediatamente.
-
Para exibir o arquivo de estado do Terraform (mostra o estado dos seus recursos após a execução do job), selecione o job de aplicação (obtenha seus detalhes) e, em seguida, selecione Exibir estado em Recursos.
Opcionalmente, selecione Mostrar alterações nesta versão.
Parabéns! Você provisionou uma instância do Compute com o Oracle Cloud Development Kit já instalado e pronto para uso. Agora você pode estabelecer conexão com a instância e usar o kit de desenvolvimento.
Execute o seguinte comando:
ssh -i <private-key> opc@<compute-instance-public-ip>
<private-key> é a chave privada associada à instância provisionada na pilha criada usando o modelo Oracle Cloud Developer Tools.
<compute-instance-public-ip> é o endereço IP da instância.
- Vá para a página Detalhes da pilha da sua instância recém-provisionada:
- Abra o menu de navegação e selecione Serviços ao Desenvolvedor. Em Resource Manager, selecione Pilhas.
- Selecione o nome da pilha para exibir sua página de detalhes.
- Selecione a guia Informações do aplicativo.
- Copie o valor do IP Público da Instância de Computação.
- Para a chave privada, siga as etapas que correspondem à opção de chave selecionada durante a criação da pilha:
- Se você tiver ativado Gerar automaticamente o par de chaves SSH , recupere a chave privada gerada: Copie o valor da Chave Privada Gerada para Acesso SSH.
- Se você desativou Gerar automaticamente o par de chaves SSH , faça referência ao caminho completo e ao nome do arquivo que contém a chave privada correspondente à chave pública que você transferiu por upload durante a criação da pilha. Observação
Quando você se conecta à sua instância, as permissões do arquivo de chave privada são validadas. Por motivos de segurança, sua chave privada deve estar acessível apenas pelo proprietário; caso contrário, você não poderá se conectar à instância. (Permissões de gravação do proprietário são necessárias para você adicionar a chave privada ao arquivo.) Para Unix ou Linux, use o comandochmod 600 (-rw-------)
.
Para obter informações gerais sobre como estabelecer conexão com instâncias do serviço Compute, consulte Estabelecendo Conexão com uma Instância.
Depois de conectado à sua instância, você poderá usar o kit de desenvolvimento instalado.
Veja os seguintes exemplos:
- CLI: Consulte Usando a CLI
Uso: Consulte Provisionamento Fácil, Atualizações de CLI
- Provedor Terraform
Uso: Consulte Provedor Terraform.
- Ansible (inclui módulos Ansible do OCI)
Uso: Consulte Criando um Exemplo de Playbook.
- SDKs:
- Go
Uso: Consulte https://godoc.org/github.com/oracle/oci-go-sdk
- Java
Uso: Consulte Conceitos.
- Python
Configuração e uso: Consulte Criptografia do Lado do Cliente.
Configuração e uso de SDKs de código-fonte aberto: Consulte SDKs de Código-Fonte Aberto
- Go
- Git: Use a ferramenta de linha de comando Git fornecida para acessar qualquer sistema de controle de versão relacionado ao Git, como Bitbucket, GitHub e GitLab.
Uso: Para obter ajuda sobre o uso do Git, acesse o terminal em sua nova instância do serviço Compute e execute
git --help
.
- Conecte-se à instância provisionada no modelo do kit de desenvolvimento do Oracle Cloud.
- Execute o comando de upgrade:
update-kit.sh
Autorização pré-configurada
A autorização do controlador de instâncias é configurada para itens do kit de desenvolvimento instalado e a instância de computação provisionada. O modelo fornece a seguinte pré-configuração:
- Um grupo dinâmico
- Uma política do serviço IAM, com todo o acesso a recursos determinado pela configuração da pilha (nível de tenancy ou compartimento)
- Variáveis de ambiente definidas em
.bashrc
na instância do serviço Compute para CLI, Terraform e Ansible
Para obter mais informações sobre autorização do controlador de instâncias, consulte Chamando Serviços de uma Instância.