In this blog, we'll review the use cases and examples for a new ECK feature released in 2.6, Elastic Stack Configuration Policies.

illustration-generic-cloud-update-1680x980-midnight.png

Introducing Elastic Cloud on Kubernetes Stack Configuration Policies

The Elastic Stack Terraform provider allows operations and SRE teams to safely manage their production-related infrastructure and fully control the configuration of Elasticsearch, Kibana, Fleet, and any other component within the Elastic Stack.

blog-thumb-hashicorp.png

Streamline configuration processes with an official Elastic Stack Terraform provider

Learn how to invite other members of your organization to collaborate with you and manage your Elastic Cloud deployments.

Members_—_Elas_(1).png

image_(1).png

blog-thumb-cloud-blue.png

How to invite teammates to access and manage Elastic Cloud deployments

Veja como é fácil começar a usar o Elastic Cloud Enterprise automatizando tudo, desde o provisionamento na nuvem até a implantação do ECE com o Terraform e o Ansible.

<p>Este post do blog é uma sequência do nosso primeiro post, intitulado <a href="/pt/blog/automating-the-install-of-elastic-cloud-enterprise-on-aws-with-ansible">Automating the installation of Elastic Cloud Enterprise with Ansible</a> (Automatizar a instalação do Elastic Cloud Enterprise com o Ansible), e mostra como estender a automação ao provisionamento na nuvem com o Terraform. No primeiro post, detalhamos como implantar e configurar o Elastic Cloud Enterprise (ECE) em três zonas de disponibilidade na AWS usando o Ansible. No entanto, o provisionamento das instâncias subjacentes do EC2 e a configuração dos grupos de segurança foram todos feitos manualmente.
</p>
<p>Neste post, aprimoraremos nossa metodologia usando o Terraform para automatizar o provisionamento e a configuração dessas instâncias do EC2 e dos grupos de segurança. Também vamos usá-lo para automatizar a instalação, a configuração e a execução do manual do Ansible que criamos da última vez. A automação é boa.
</p>
<p>A propósito, o que é o Terraform? Não tem nada a ver com o dispositivo <a href="https://pt.wikipedia.org/wiki/Star_Trek_II:_The_Wrath_of_Khan">Genesis</a> como eu pensava inicialmente. De acordo com a <a href="https://www.terraform.io/intro/index.html#what-is-terraform-">HashiCorp</a> (os desenvolvedores), trata-se de uma ferramenta para desenvolvimento, alteração e controle de versão da infraestrutura usando configuração de alto nível: infraestrutura como código. Isso é útil por vários motivos, entre os quais o fato de que tudo o que é necessário para montar, executar e configurar a sua infraestrutura reside em arquivos de texto que podem ter controle de versão e ser CRUDados (nossa, inventei uma palavra!) programaticamente.
</p>
<p>Embora o foco deste post seja a AWS como provedor de serviços em nuvem, você pode usar o Terraform para provisionar e gerenciar recursos em qualquer provedor. Confira a <a href="https://www.terraform.io/docs/providers/type/major-index.html">lista dos maiores provedores de serviços em nuvem</a> deles e a <a href="https://www.terraform.io/docs/providers/type/cloud-index.html">lista dos provedores</a> de escala (aparentemente) um pouco menor. Um exemplo usando o GCP está disponível no nosso <a href="https://github.com/elastic/examples/tree/master/Cloud%20Enterprise/Getting%20Started%20Examples/gcp/terraform">repositório de exemplos</a> no GitHub.
</p>
<p>E, por fim, como antes, este post do blog é uma demonstração básica que criará um ambiente do ECE adequado para uma pequena prova de conceito ou ambiente de desenvolvimento. Uma implantação de produção completa deve usar grupos de instâncias, balanceadores de carga e outras construções de alta disponibilidade que foram deixadas de fora desta configuração. Consulte os <a href="/guide/en/cloud-enterprise/1.1/ece-planning.html">documentos de planejamento do Elastic Cloud Enterprise</a> para ver detalhes adicionais sobre planejamento e implantação para produção.
</p>
<p>Vamos começar?
</p>
<h2>Tarefas
</h2>
<p>Mais uma vez, vamos seguir o exemplo de <a href="/guide/en/cloud-enterprise/2.2/ece-topology-example1.html">pequena instalação de linha de base</a> da documentação do ECE, mas nossas tarefas são bem diferentes:
</p>
<ol>
	<li>Instalar o Terraform</li>
	<li>Definir a infraestrutura</li>
	<li>Executá-lo</li>
	<li>Tadaaa!!!</li>
</ol>
<h3>Instalar o Terraform
</h3>
<p>A <a href="https://www.terraform.io/downloads.html">documentação da HashiCorp</a> é ideal para isso. Você também precisará do Ansible, que instalamos no primeiro post do blog. Se ainda não fez isso, consulte os <a href="https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html">a documentação do Ansible</a>. No meu caso, como eu uso um Macbook Pro, digitei o seguinte:
</p>
<pre class="prettyprint">&gt; brew install terraform
&gt; brew install ansible
</pre>
<p>É importante observar que a configuração que usei é compatível com o Terraform versão 0.12. Eu usei especificamente a versão 0.12.19.
</p>
<h3>Definir a infraestrutura
</h3>
<p>As etapas nesta tarefa são:
</p>
<ol>
	<li>Inicializar a sua configuração do Terraform com aquelas que eu usei.</li>
	<li>Navegar por elas para ter uma noção do que está acontecendo.</li>
	<li>Definir algumas variáveis que esperamos que sejam exclusivas para você.</li>
</ol>
<h4>Inicializar a sua configuração do Terraform</h4>
<p>Como foi dito anteriormente, o Terraform é uma maneira de provisionar a infraestrutura por meio de arquivos de configuração. Portanto, existem muitos arquivos de configuração. Para avançar mais rapidamente, clone o repositório ou baixe os arquivos do nosso <a href="https://github.com/elastic/examples">repositório de exemplos no GitHub</a>. Tudo o que vamos fazer é feito nesses arquivos.
</p>
<p>Como antes, minhas etapas são adaptadas para pessoas inclinadas a trabalhar com a interface de linha de comando como eu, pois é muito mais difícil escrever instruções de apontar e clicar!
</p>
<h5>Etapas</h5>
<ol>
	<li>Clone ou baixe do repositório de exemplos.
	<pre class="prettyprint">&gt; git clone https://github.com/elastic/examples.git
	</pre>
	</li>
	<li>Navegue até onde você salvou o arquivo.
	<pre class="prettyprint">&gt; cd /workspace/github/elastic/examples
	</pre>
	</li>
	<li>Navegue até os exemplos do Terraform na AWS com ECE.
	<pre class="prettyprint">&gt; cd Cloud\ Enterprise/Getting\ Started\ Examples/aws/terraform
	</pre>
	</li>
	<li>Prepare-se para fazer um pouco de <a href="https://media.giphy.com/media/fQZX2aoRC1Tqw/giphy.gif">edição de texto</a>.</li>
</ol>
<h4>Navegar pelos arquivos</h4>
<p>Você deverá ter os arquivos a seguir à sua frente. Navegue por eles se quiser.
</p>
<table>
<tbody>
<tr>
	<td><code style="white-space: nowrap">terraform.tfvars.example</code>
	</td>
	<td>Depois de renomear para <code>terraform.tfvars</code>, esse é o principal local onde definimos nossas coisas secretas e substituímos qualquer variável em <code>variables.tf</code> que desejamos.
	</td>
</tr>
<tr>
	<td><code>variables.tf</code>
	</td>
	<td>Grupos de variáveis; provavelmente seria bom você dar uma olhada nisso.
	</td>
</tr>
<tr>
	<td><code>provider.tf</code>
	</td>
	<td>Configuração do Terraform para dizer a ele como se conectar à AWS.
	</td>
</tr>
<tr>
	<td><code>servers.tf</code>
	</td>
	<td>Configuração do Terraform para encontrar a nossa AMI desejada, implantar nossas instâncias e capturar os metadados das instâncias para uso pelo Ansible.
	</td>
</tr>
<tr>
	<td><code>networking.tf</code>
	</td>
	<td>Configuração do Terraform que faz várias configurações de rede da AWS: uma VPC, um gateway da internet, uma tabela de roteamento, uma sub-rede e grupos de segurança.
	</td>
</tr>
<tr>
	<td><code>main.tf</code>
	</td>
	<td>Configuração do Terraform que executa o script do Ansible e coleta algumas de suas saídas mais importantes.
	</td>
</tr>
<tr>
	<td><code>ansible-install.sh</code>
	</td>
	<td>O Terraform do script modificará e chamará para configurar e executar o Ansible com a função do ECE.
	</td>
</tr>
</tbody>
</table>
<h4>Definir variáveis
</h4>
<p>Precisamos definir algumas variáveis diferentes para que isso funcione para você (porque eu já fiz funcionar para mim e agora o negócio é com você).
</p>
<ul>
	<li>Um nome de projeto que será marcado em todos os recursos da AWS que forem criados</li>
	<li>Seu IP para que somente você tenha acesso SSH às instâncias subjacentes; definir como <code>0.0.0.0/0</code> também funcionaria se você quisesse abri-lo para o mundo</li>
	<li>Credenciais de acesso da AWS para permitir que o Terraform provisione coisas</li>
</ul>
<p>Se você não tem um par de chaves secretas/de acesso da AWS, siga a <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey">documentação da AWS para criar um</a>.
</p>
<p><strong>Observação:</strong> <code>variables.tf</code> define um local de arquivos de chave pública e privada a ser usado para acesso seguro (por SSH) nas instâncias do EC2. Se você não tem uma chave de SSH, sugiro que você pesquise no Google. A DigitalOcean tem uma boa descrição básica para <a href="https://www.digitalocean.com/docs/droplets/how-to/add-ssh-keys/create-with-openssh/">Linux/OSX</a> e <a href="https://www.digitalocean.com/docs/droplets/how-to/add-ssh-keys/create-with-putty/">Windows</a>.
</p>
<h5>Etapas</h5>
<ol>
	<li>Renomeie <code>terraform.tfvars.example</code> como <code>terraform.tfvars</code>.</li>
	<li>Em <code>terraform.tfvars</code>, faça as seguintes alterações:
	<ol>
		<li>Defina um <code>project_name</code> usado para identificar todos os seus recursos da AWS.</li>
		<li>Defina <code>trust_network</code> como seu IP na <a href="https://pt.wikipedia.org/wiki/Classless_Inter-Domain_Routing">notação CIDR</a> ou no intervalo que você preferir.</li>
		<li>Defina <code>aws_access_key</code> e <code>aws_secret_key</code> com suas informações.</li>
		<li>Opcionalmente, substitua <code>aws_region</code>, <code>public_key</code> e/ou <code>private_key</code>.</li>
	</ol></li>
</ol>
<p>Duas configurações que não estou pedindo para você alterar são as configurações da AMI e do tipo de instância do EC2. Existem algumas razões para isso, mas o objetivo é principalmente reduzir a complexidade ao iniciar. Como na última vez, nosso plano é implantar três instâncias i3.xlarge a partir de uma AMI CentOS 7.
</p>
<ul>
	<li>Para garantir que o Terraform encontre a AMI correta, podemos fornecer vários metadados. Nesse caso, usei um padrão de nome, uma ID de proprietário (centos.org) e um tipo de virtualização. O padrão de nome e a ID do proprietário são configuráveis em <code>variables.tf</code>, mas esteja ciente de que, se selecionar uma AMI diferente (por exemplo, uma com Ubuntu), você poderá precisar de um valor diferente para <code>remote_user</code>.</li>
	<li>A alteração do tipo de instância também tem ramificações. As instâncias i3 usam unidades NVMe conectadas localmente que têm um nome de dispositivo OS e definições de configuração específicos no Terraform. Se você usar uma instância diferente e anexar volumes do EBS, precisará alterar <code>servers.tf</code> para mapeá-la corretamente. Consulte a documentação do Terraform para obter mais informações.</li>
</ul>
<p>As configurações que usei para a AMI e o tipo de instância do EC2 podem ser vistas em <code>variables.tf</code>.
</p>
<h4></h4>
<pre class="prettyprint"># O nome da AMI no AWS Marketplace
variable "aws_ami_name" {
  default = "CentOS Linux 7 x86_64 HVM*"
}
# O proprietário da AMI
variable "aws_ami_owner" {
  default = "679593333241" # centos.org
}
# O usuário para fazer login nas instâncias e executar a instalação
# Isso depende da AMI usada; portanto, verifique se elas estão sincronizadas. Por exemplo, uma AMI do Ubuntu utilizaria o usuário ubuntu
variable "remote_user" {
  default = "centos"
}
# Tipo de instância do ECE
variable "aws_instance_type" {
  default = "i3.xlarge"
}
# O nome do dispositivo do volume não raiz que será usado pelo ECE
# Para instâncias i3, é nvme0n1.
# Se você usar um tipo de instância diferente, esse valor mudará e também poderá exigir alterações na definição do recurso em servers.tf
variable "device_name" {
  default="nvme0n1"
}
</pre>
<h2>Executá-lo
</h2>
<p>Está praticamente pronto. Muito louco, né? É possível que, se simplesmente prosseguisse com os padrões e não passasse muito tempo investigando todos os arquivos de configuração, neste ponto, você tivesse acabado de instalar o Terraform, copiado alguns arquivos e definido algumas variáveis. E depois? Depois é só executar o negócio!
</p>
<h5>Etapas
</h5>
<ol>
	<li>Inicialize o Terraform.
	<pre class="prettyprint">&gt; terraform init
	</pre>
	</li>
	<li>Aplique as configurações que trabalhamos tanto para construir.
	<pre class="prettyprint">&gt; terraform apply
	</pre>
	</li>
</ol>
<p>Sim. É isso aí!
</p>
<p>Depois de alguns minutos, você deverá obter uma saída como a mostrada abaixo, que informa a URL e a senha do administrador do console de administração do ECE:
</p>
<pre class="prettyprint">null_resource.run-ansible (local-exec): TASK [ansible-elastic-cloud-enterprise : debug] ********************************
null_resource.run-ansible (local-exec): ok: [ec2-52-70-7-3.compute-1.amazonaws.com] =&gt; {
null_resource.run-ansible (local-exec):     "msg": "Adminconsole is reachable at: https://ec2-35-175-235-131.compute-1.amazonaws.com:12443"
null_resource.run-ansible (local-exec): }
null_resource.run-ansible (local-exec): TASK [ansible-elastic-cloud-enterprise : debug] ********************************
null_resource.run-ansible (local-exec): ok: [ec2-52-70-7-3.compute-1.amazonaws.com] =&gt; {
null_resource.run-ansible (local-exec):     "msg": "Adminconsole password is: yI6ClXYNQ5LGiZlBuOm94s8hGV5ispQS24WVfL5fE9q"
null_resource.run-ansible (local-exec): }
null_resource.run-ansible (local-exec): TASK [ansible-elastic-cloud-enterprise : include_tasks] ************************
null_resource.run-ansible (local-exec): skipping: [ec2-52-70-7-3.compute-1.amazonaws.com]
null_resource.run-ansible (local-exec): PLAY RECAP *********************************************************************
null_resource.run-ansible (local-exec): ec2-34-229-205-85.compute-1.amazonaws.com : ok=68   changed=37   unreachable=0    failed=0    skipped=7    rescued=0    ignored=1
null_resource.run-ansible (local-exec): ec2-35-175-235-131.compute-1.amazonaws.com : ok=68   changed=29   unreachable=0    failed=0    skipped=8    rescued=0    ignored=1
null_resource.run-ansible (local-exec): ec2-52-70-7-3.compute-1.amazonaws.com : ok=68   changed=37   unreachable=0    failed=0    skipped=7    rescued=0    ignored=1
null_resource.run-ansible: Creation complete after 16m50s [id=7701810896203834102]
Apply complete! Resources: 1 added, 0 changed, 1 destroyed.
Outputs:
ece-instances = [
  [
    "ec2-35-175-235-131.compute-1.amazonaws.com",
    "ec2-34-229-205-85.compute-1.amazonaws.com",
    "ec2-52-70-7-3.compute-1.amazonaws.com",
  ],
]
installed-ece-url = https://ec2-35-175-235-131.compute-1.amazonaws.com:12443
</pre>
<p>Incentivo você a abri-lo e brincar um pouco com ele. Não tenha medo! Se você fizer alguma besteira, poderá simplesmente destruir tudo e recriar da seguinte forma:
</p>
<pre class="prettyprint">&gt; terraform destroy
&gt; terraform apply
</pre>
<p><strong>Observação:</strong> os certificados usados para TLS são autoassinados; portanto, você receberá um aviso no navegador quando tentar acessar o console de administração. Você poderá configurar o ECE para usar os seus próprios certificados. Leia mais sobre isso <a href="/guide/en/cloud-enterprise/2.4/ece-manage-certificates.html">na documentação</a>.
</p>
<h2>Tadaaa!!!
</h2>
<p><a href="https://media.giphy.com/media/142UITjG5GjIRi/giphy.gif">T</a><a href="https://media.giphy.com/media/BNKGM6uOgPhp6/giphy.gif">a</a><a href="https://media.giphy.com/media/2w6KRYh2YXHUJapKUP/giphy.gif">d</a><a href="https://media.giphy.com/media/dypH0OkYT4IjmpYvgS/giphy.gif">a</a><a href="https://media.giphy.com/media/lIvc3HDLro9aw/giphy.gif">a</a><a href="https://media.giphy.com/media/Lqms45fChZqZZnvANl/giphy.gif">a</a><a href="https://media.giphy.com/media/LUd1RnoGO2vlu/giphy.gif">!</a><a href="https://media.giphy.com/media/wfApg2GUjJ6rm/giphy.gif">!</a><a href="https://media.giphy.com/media/zL6Xl2A5R8yNG/giphy.gif">!</a>
</p>
<p>Espero que você concorde que o nível de esforço desta vez foi substancialmente menor do que da última vez. Conseguimos evitar totalmente o console da AWS e as cerca de 38 etapas que usamos para que todos os recursos fossem implantados, configurados e protegidos (este novo método tem 10 etapas pelas minhas contas).
</p>
<p>Agora vá em frente e explore, pois a nuvem é pequena e você é um gigante! <a href="/pt/ece">Brinque com o ECE</a>, inicialize os clusters, atualize-os e redimensione-os. Desfrute da facilidade e da simplicidade.
</p>

blog-factory-line-robots-banner.jpg

terraform-ansible-ece.png

Automate all the things: Terraform + Ansible + Elastic Cloud Enterprise

Automatize tudo: Terraform + Ansible + Elastic Cloud Enterprise

Start free trial

Blog Footer CTA

Sign up for Elastic Cloud free trial

Product Manager

Omer Kushmaro

The content on this page is not available in the selected language. As Elastic grows globally, we continue to support content in multiple languages.

The content on this page is not available in the selected language.

O conteúdo desta página não está disponível no idioma selecionado. A Elastic está trabalhando para garantir que o conteúdo esteja disponível em vários idiomas. Agradecemos a compreensão.

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_self">Terms of Service</a>, and you agree to receive the <a href="/legal/privacy-statement#how-we-use-the-information" target="_self">selected communications</a> at the contact details you provided above. See <a href="/legal/privacy-statement/" target="_self">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Communication Preferences - ONLY for /communication-preferences

<p>Ao enviar a confirmação, você reconhece que leu e concorda com nossos <a href="/pt/legal/elastic-cloud-account-terms" target="_self">Termos de Serviço</a> e também concorda em receber <a href="/pt/legal/privacy-statement#how-we-use-the-information" target="_self">comunicações especiais</a> por meio dos dados de contato que forneceu acima. Consulte a <a href="/pt/legal/privacy-statement/" target="_self">Declaração de Privacidade da Elastic</a> para saber mais detalhes ou para cancelar a qualquer momento.</p>

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/serverless-preview-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Serverless GDPR Text

<p>Ao enviar a confirmação, você reconhece que leu e concorda com nossos <a href="/pt/legal/serverless-preview-terms" target="_self">Termos de Serviço</a> e que a Elastic pode <a href="/pt/legal/privacy-statement#how-we-use-the-information" target="_self">entrar em contato com você</a> para divulgar nossos produtos e serviços relacionados usando os dados que você forneceu acima. Consulte a <a href="/pt/legal/privacy-statement/" target="_self">Declaração de Privacidade da Elastic</a> para saber mais detalhes ou para cancelar a qualquer momento.</p>

<p>By submitting you agree to <a href="/agreements/global/cloud-services-monthly" rel="nofollow">Elastic Cloud Terms of Service</a>. Your personal data will be processed in accordance with <a href="/legal/privacy-statement">Elastic's Privacy Statement</a>.</p>

Cloud Trial GDPR Text

<p>Ao enviar, você concorda com os <a href="/pt/agreements/global/cloud-services-monthly" rel="nofollow">Termos de Serviço do Elastic Cloud</a>. Seus dados pessoais serão tratados de acordo com a <a href="/pt/legal/privacy-statement">Declaração de Privacidade da Elastic</a>.
</p>

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/terms-of-use" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Newsletter GDPR Text

<p>Ao enviar a confirmação, você reconhece que leu e concorda com nossos <a href="/pt/legal/terms-of-use" target="_self">Termos de Serviço</a> e que a Elastic pode <a href="/pt/legal/privacy-statement#how-we-use-the-information" target="_self">entrar em contato com você</a> para divulgar nossos produtos e serviços relacionados usando os dados que você forneceu acima. Consulte a <a href="/pt/legal/privacy-statement/" target="_self">Declaração de Privacidade da Elastic</a> para saber mais detalhes ou para cancelar a qualquer momento.</p>

Explore similar demos

Explore outras demonstrações semelhantes

Overview

Load More

Speakers

Close

See more insights

Author

Articles by

Learn more

Watch now (no PT)

Watch now

See all top stories

All (no PT translation)

Contact information

Press Release

Share on Reddit

Share this story

Share by Email

Thank you for your interest!

Contact Info

Follow us on Youtube

Share on LinkedIn

Follow us on LinkedIn

Search Integrations

All Solutions

Video for

Follow us on Twitter

See when this webinar starts in my time zone

Consultar a hora de início do webinar no meu fuso horário

Register to Watch

Register now

See All Posts

Can't make it? Register and we'll send you the recording. You'll also receive an email with related content

Não vai conseguir participar? Inscreva-se e nós lhe enviaremos a gravação. Você também receberá um email com conteúdo relacionado.

Author

Articles by Omer Kushmaro

Product Manager, Elastic

Introducing Elastic Cloud on Kubernetes Stack Configuration Policies

Streamline configuration processes with an official Elastic Stack Terraform provider

How to invite teammates to access and manage Elastic Cloud deployments

Automatize tudo: Terraform + Ansible + Elastic Cloud Enterprise