http://wiki.mstech.com.br/api.php?action=feedcontributions&feedformat=atom&user=Edson.rodriguesMSTECH wiki - Contribuições do usuário [pt-br]2026-05-07T14:18:43ZContribuições do usuárioMediaWiki 1.26.2http://wiki.mstech.com.br/index.php?title=Puppet&diff=3323Puppet2016-11-14T18:11:42Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devops.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ># vi /etc/sysconfig/puppetserver</syntaxhighlight ><br />
<syntaxhighlight lang="vim" >JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="vi" > <br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devops.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="console" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="vim" ><br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devops.com.br<br />
<syntaxhighlight lang="console" ># puppet cert list</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="console" ># puppet cert sign agente-puppet.mstech.com.br</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devops.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
=== '''Criação de módulos de configuração''' ===<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="console" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devops-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="vi" ><br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devops.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devops.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="console" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="console" >cd /etc/puppetlabs/code/environments/production/manifests<br />
# vi site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="vim" > <br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="vim" ><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devops.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devops.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devops.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devops.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
==== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="console" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devops-checklist”.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="vim" ><br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/code/environments/production/manifests/site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="vim" ><br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3322Puppet2016-11-14T18:11:04Z<p>Edson.rodrigues: </p>
<hr />
<div>$wgGroupPermissions['*']['edit'] = false;<br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devops.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ># vi /etc/sysconfig/puppetserver</syntaxhighlight ><br />
<syntaxhighlight lang="vim" >JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="vi" > <br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devops.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="console" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="vim" ><br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devops.com.br<br />
<syntaxhighlight lang="console" ># puppet cert list</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="console" ># puppet cert sign agente-puppet.mstech.com.br</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devops.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
=== '''Criação de módulos de configuração''' ===<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="console" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devops-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="vi" ><br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devops.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devops.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="console" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="console" >cd /etc/puppetlabs/code/environments/production/manifests<br />
# vi site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="vim" > <br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="vim" ><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devops.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devops.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devops.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devops.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
==== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="console" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devops-checklist”.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="vim" ><br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/code/environments/production/manifests/site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="vim" ><br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3198Puppet2016-11-03T12:37:36Z<p>Edson.rodrigues: /* – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes */</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devops.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ># vi /etc/sysconfig/puppetserver</syntaxhighlight ><br />
<syntaxhighlight lang="vim" >JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="vi" > <br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devops.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="console" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="vim" ><br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devops.com.br<br />
<syntaxhighlight lang="console" ># puppet cert list</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="console" ># puppet cert sign agente-puppet.mstech.com.br</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devops.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
=== '''Criação de módulos de configuração''' ===<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="console" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devops-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="vi" ><br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devops.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devops.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="console" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="console" >cd /etc/puppetlabs/code/environments/production/manifests<br />
# vi site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="vim" > <br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="vim" ><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devops.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devops.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devops.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devops.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
==== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="console" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devops-checklist”.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="vim" ><br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/code/environments/production/manifests/site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="vim" ><br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3197Puppet2016-11-03T12:35:12Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devops.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ># vi /etc/sysconfig/puppetserver</syntaxhighlight ><br />
<syntaxhighlight lang="vim" >JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="vi" > <br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devops.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="console" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="vim" ><br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devops.com.br<br />
<syntaxhighlight lang="console" ># puppet cert list</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="console" ># puppet cert sign agente-puppet.mstech.com.br</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devops.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
=== '''Criação de módulos de configuração''' ===<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="console" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devops-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="vi" ><br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devops.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devops.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="console" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="console" >cd /etc/puppetlabs/code/environments/production/manifests<br />
# vi site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="vim" > <br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="vim" ><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devops.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devops.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devops.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devops.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
==== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="console" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devops-checklist”.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="vim" ><br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/code/environments/production/manifests/site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="vim" > <br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3196Puppet2016-11-03T12:31:31Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devops.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ># vi /etc/sysconfig/puppetserver</syntaxhighlight ><br />
<syntaxhighlight lang="vim" line="1" >JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="vi" line="1" > <br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devops.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="console" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="vim" line="1" ><br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devops.com.br<br />
<syntaxhighlight lang="console" ># puppet cert list</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="console" ># puppet cert sign agente-puppet.mstech.com.br</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devops.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
=== '''Criação de módulos de configuração''' ===<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="console" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devops-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="console" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="vi" line="1" ><br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devops.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devops.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="console" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="console" >cd /etc/puppetlabs/code/environments/production/manifests<br />
# vi site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="vim" line="1" > <br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="vim" line="1"><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devops.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devops.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devops.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devops.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
==== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="console" line="1" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devops-checklist”.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="vim" line="1" ><br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/code/environments/production/manifests/site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="vim" line="1" > <br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3195Puppet2016-11-03T12:22:47Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devops.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ># vi /etc/sysconfig/puppetserver</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" >JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" > [agent]<br />
server = puppet.mstech.com.br</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devops.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="console" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
[agent]<br />
server = puppet.mstech.com.br</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devops.com.br<br />
<syntaxhighlight lang="console" ># puppet cert list</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="console" ># puppet cert sign agente-puppet.mstech.com.br</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devops.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
=== '''Criação de módulos de configuração''' ===<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="console" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devops-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="console" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devops.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devops.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="console" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="console" >cd /etc/puppetlabs/code/environments/production/manifests</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" > <br />
# vi site.pp<br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="console" line="1"><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devops.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devops.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="console" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devops.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devops.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
==== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="console" line="1" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devops-checklist”.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="console" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/code/environments/production/manifests/site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" > <br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="console" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3194Puppet2016-11-03T12:17:27Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devops.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ># vi /etc/sysconfig/puppetserver</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" >JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" > [agent]<br />
server = puppet.mstech.com.br</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devops.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="sql" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="sql" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" ><br />
[agent]<br />
server = puppet.mstech.com.br</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="sql" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="sql" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" ><br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devops.com.br<br />
<syntaxhighlight lang="sql" ># puppet cert list</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" ><br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="sql" ># puppet cert sign agente-puppet.mstech.com.br</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" ><br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devops.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
=== '''Criação de módulos de configuração''' ===<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devops-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" ><br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devops.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devops.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devops.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="sql" >cd /etc/puppetlabs/code/environments/production/manifests</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" > <br />
# vi site.pp<br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="sql" line="1"><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="sql" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devops.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devops.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devops.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="sql" ># cat /etc/hosts</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" ><br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devops.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devops.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devops.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
==== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="sql" line="1" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devops-checklist”.<br />
<syntaxhighlight lang="sql" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devops-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" ><br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="sql" ># vi /etc/puppetlabs/code/environments/production/manifests/site.pp</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" > <br />
node 'puppetclient-01.devops.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" ># puppet agent -t</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devops.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3193Puppet2016-11-03T12:06:56Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ># vi /etc/puppetlabs/puppet/puppet.conf</syntaxhighlight ><br />
<syntaxhighlight lang="sql" line="1" > [agent]<br />
server = puppet.mstech.com.br</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="sql" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="sql" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert list<br />
<br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert sign agente-puppet.mstech.com.br<br />
<br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
=== '''Criação de módulos de configuração''' ===<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devopslab-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="sql" ><br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
# vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="sql" line="1"><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cat /etc/hosts<br />
<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
==== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="sql" line="1" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
<syntaxhighlight lang="sql" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
<br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3192Puppet2016-11-03T12:03:43Z<p>Edson.rodrigues: /* – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes */</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="sql" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="sql" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert list<br />
<br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert sign agente-puppet.mstech.com.br<br />
<br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
=== '''Criação de módulos de configuração''' ===<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devopslab-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="sql" ><br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
# vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="sql" line="1"><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cat /etc/hosts<br />
<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
==== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="sql" line="1" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
<syntaxhighlight lang="sql" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
<br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3191Puppet2016-11-03T12:02:47Z<p>Edson.rodrigues: /* – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes = */</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="sql" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="sql" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert list<br />
<br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert sign agente-puppet.mstech.com.br<br />
<br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
=== '''Criação de módulos de configuração''' ===<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devopslab-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="sql" ><br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
# vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="sql" line="1"><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cat /etc/hosts<br />
<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
=== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ===<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="sql" line="1" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
<syntaxhighlight lang="sql" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
<br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3190Puppet2016-11-03T12:01:59Z<p>Edson.rodrigues: /* Criação de módulos de configuração */</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="sql" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="sql" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert list<br />
<br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert sign agente-puppet.mstech.com.br<br />
<br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
=== '''Criação de módulos de configuração''' ===<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devopslab-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="sql" ><br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
# vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="sql" line="1"><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cat /etc/hosts<br />
<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
=== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="sql" line="1" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
<syntaxhighlight lang="sql" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
<br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3189Puppet2016-11-03T12:00:15Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="sql" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="sql" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert list<br />
<br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert sign agente-puppet.mstech.com.br<br />
<br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
==== '''Criação de módulos de configuração''' ====<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devopslab-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="sql" ><br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
# vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="sql" line="1"><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cat /etc/hosts<br />
<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
=== – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, um checklist mesmo.<br />
<syntaxhighlight lang="sql" line="1" ><br />
- Checklist<br />
- Telnet – Instalar<br />
- Openssh – Manter atualizado na última versão.<br />
- Gnutils – Manter atualizado na última versão.<br />
- Vim – Remover<br />
</syntaxhighlight ><br />
<br />
'''No PUPPET SERVER.'''<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
<syntaxhighlight lang="sql" ><br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
</syntaxhighlight ><br />
<br />
Criação do manifesto.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
<br />
class checklist::pacotes {<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
}<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
</syntaxhighlight ><br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
</syntaxhighlight ><br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
<br />
Obrigado.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3188Puppet2016-11-03T11:51:53Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="sql" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="sql" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert list<br />
<br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert sign agente-puppet.mstech.com.br<br />
<br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
==== '''Criação de módulos de configuração''' ====<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devopslab-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="sql" ><br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
# vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="sql" line="1"><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
=== 6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes ===<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
# vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3187Puppet2016-11-03T11:46:52Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Laboratório.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “agente-puppet.mstech.com.br”.<br />
Faça o login no host cliente (agente-puppet.mstech.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
<syntaxhighlight lang="sql" ><br />
# source /etc/profile.d/puppet-agent.sh<br />
</syntaxhighlight ><br />
<br />
Edite o puppet.conf e aponte para o Puppet Server.<br />
<syntaxhighlight lang="sql" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
<syntaxhighlight lang="sql" ><br />
# systemctl enable puppet.service<br />
# systemctl start puppet.service<br />
</syntaxhighlight ><br />
<br />
Rode o puppet pela primeira vez.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Exiting; no certificate found and waitforcert is disabled<br />
</syntaxhighlight ><br />
<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert list<br />
<br />
"agente-puppet.mstech.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
</syntaxhighlight ><br />
<br />
Assinatura do certificado.<br />
<syntaxhighlight lang="sql" ><br />
# puppet cert sign agente-puppet.mstech.com.br<br />
<br />
Notice: Signed certificate request for agente-puppet.mstech.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest agente-puppet.mstech.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/agente-puppet.mstech.com.br.pem'<br />
</syntaxhighlight ><br />
<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
<syntaxhighlight lang="sql" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
</syntaxhighlight ><br />
<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
==== '''Criação de módulos de configuração''' ====<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devopslab-edithosts --skip-interview<br />
</syntaxhighlight ><br />
<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
</syntaxhighlight ><br />
<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
<syntaxhighlight lang="sql" ><br />
# puppet parser validate hosts.pp<br />
</syntaxhighlight ><br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
<syntaxhighlight lang="sql" ><br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
# vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
</syntaxhighlight ><br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<syntaxhighlight lang="sql" line="1"><br />
node <br />
'puppetclient-01.mstech.com.br',<br />
'puppetclient-02.mstech.com.br',<br />
'puppetclient-03.mstech.com.br',<br />
'puppetclient-04.mstech.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
# adicione aqui outros modulo criados<br />
}<br />
</syntaxhighlight ><br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
</syntaxhighlight ><br />
<br />
Verificando as alterações no /etc/hosts.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
192.168.13.42 agente-puppet.mstech.com.br agente-puppet<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
</syntaxhighlight ><br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
==== 6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes =====<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
# vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3186Puppet2016-11-03T09:40:37Z<p>Edson.rodrigues: /* Instalação e configuração do Cliente */</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida e instalação de Sistema Operacional de forma automatizada.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts, isto se tornará trivial.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Lab.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “puppetclient-01.devopslab.com.br”.<br />
Faça o login no host cliente (puppetclient-01.devopslab.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
# yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
# source /etc/profile.d/puppet-agent.sh<br />
Edite o puppet.conf e aponte para o server Puppet Server.<br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
systemctl enable puppet.service<br />
systemctl start puppet.service<br />
Rode o puppet pela primeira vez.<br />
# puppet agent -t<br />
Exiting; no certificate found and waitforcert is disabled<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
# puppet cert list<br />
root@puppetserver-01 ~]# puppet cert list<br />
"puppetclient-01.devopslab.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
Assinatura do certificado.<br />
[root@puppetserver-01 ~]# puppet cert sign puppetclient-01.devopslab.com.br<br />
Notice: Signed certificate request for puppetclient-01.devopslab.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest puppetclient-01.devopslab.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/puppetclient-01.devopslab.com.br.pem'<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
[root@puppetclient-01 ~]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
==== '''Criação de módulos de configuração''' ====<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devopslab-edithosts --skip-interview<br />
</syntaxhighlight ><br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
# puppet parser validate hosts.pp<br />
<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
# vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
<br />
node <br />
'puppetclient-01.devopslab.com.br',<br />
'puppetclient-02.devopslab.com.br',<br />
'puppetclient-03.devopslab.com.br',<br />
'puppetclient-04.devopslab.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
}<br />
<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
Verificando as alterações no /etc/hosts.<br />
<br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
10.0.0.161 puppetclient-01.devopslab.com.br puppetclient-01<br />
10.0.0.160 puppetserver-01.devopslab.com.br puppetserver-01<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
<br />
6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
# cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
# vi pacotes.pp<br />
<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
# vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3185Puppet2016-11-03T09:37:02Z<p>Edson.rodrigues: /* Módulo 1 – Edição do arquivo /etc/hosts */</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida e instalação de Sistema Operacional de forma automatizada.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts, isto se tornará trivial.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Lab.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “puppetclient-01.devopslab.com.br”.<br />
Faça o login no host cliente (puppetclient-01.devopslab.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
#rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
<br />
#yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
#source /etc/profile.d/puppet-agent.sh<br />
Edite o puppet.conf e aponte para o server Puppet Server.<br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
systemctl enable puppet.service<br />
systemctl start puppet.service<br />
Rode o puppet pela primeira vez.<br />
#puppet agent -t<br />
Exiting; no certificate found and waitforcert is disabled<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
#puppet cert list<br />
root@puppetserver-01 ~]# puppet cert list<br />
"puppetclient-01.devopslab.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
Assinatura do certificado.<br />
[root@puppetserver-01 ~]# puppet cert sign puppetclient-01.devopslab.com.br<br />
Notice: Signed certificate request for puppetclient-01.devopslab.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest puppetclient-01.devopslab.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/puppetclient-01.devopslab.com.br.pem'<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
[root@puppetclient-01 ~]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
==== '''Criação de módulos de configuração''' ====<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada.<br />
<br />
'''No PUPPET SERVER'''<br />
<syntaxhighlight lang="sql" line="1" ><br />
# puppet module generate<br />
# cd /etc/puppetlabs/code/environments/production/modules<br />
# puppet module generate devopslab-edithosts --skip-interview<br />
</syntaxhighlight ><br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
<syntaxhighlight lang="sql" line="1" ><br />
# cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
# vi hosts.pp<br />
<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
#puppet parser validate hosts.pp<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
#vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
node <br />
'puppetclient-01.devopslab.com.br',<br />
'puppetclient-02.devopslab.com.br',<br />
'puppetclient-03.devopslab.com.br',<br />
'puppetclient-04.devopslab.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
}<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
Verificando as alterações no /etc/hosts.<br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
10.0.0.161 puppetclient-01.devopslab.com.br puppetclient-01<br />
10.0.0.160 puppetserver-01.devopslab.com.br puppetserver-01<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
#cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
#vi pacotes.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
#vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
[root@puppetclient-01 /]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3184Puppet2016-11-03T09:32:58Z<p>Edson.rodrigues: /* Criação de módulos de configuração */</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida e instalação de Sistema Operacional de forma automatizada.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts, isto se tornará trivial.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Lab.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “puppetclient-01.devopslab.com.br”.<br />
Faça o login no host cliente (puppetclient-01.devopslab.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
#rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
<br />
#yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
#source /etc/profile.d/puppet-agent.sh<br />
Edite o puppet.conf e aponte para o server Puppet Server.<br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
systemctl enable puppet.service<br />
systemctl start puppet.service<br />
Rode o puppet pela primeira vez.<br />
#puppet agent -t<br />
Exiting; no certificate found and waitforcert is disabled<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
#puppet cert list<br />
root@puppetserver-01 ~]# puppet cert list<br />
"puppetclient-01.devopslab.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
Assinatura do certificado.<br />
[root@puppetserver-01 ~]# puppet cert sign puppetclient-01.devopslab.com.br<br />
Notice: Signed certificate request for puppetclient-01.devopslab.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest puppetclient-01.devopslab.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/puppetclient-01.devopslab.com.br.pem'<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
[root@puppetclient-01 ~]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
==== '''Criação de módulos de configuração''' ====<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada. Criação de módulos é um assunto extenso, existem várias maneiras de fazer a mesma coisa, das simples as mais complexas, aqui vamos utilizar apenas a forma mais recomendada.<br />
No PUPPET SERVER<br />
#puppet module generate<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
#puppet module generate devopslab-edithosts --skip-interview<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
#cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
#vi hosts.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
20<br />
21<br />
22<br />
23<br />
24<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
#puppet parser validate hosts.pp<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
#vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
node <br />
'puppetclient-01.devopslab.com.br',<br />
'puppetclient-02.devopslab.com.br',<br />
'puppetclient-03.devopslab.com.br',<br />
'puppetclient-04.devopslab.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
}<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
Verificando as alterações no /etc/hosts.<br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
10.0.0.161 puppetclient-01.devopslab.com.br puppetclient-01<br />
10.0.0.160 puppetserver-01.devopslab.com.br puppetserver-01<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
#cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
#vi pacotes.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
#vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
[root@puppetclient-01 /]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3177Puppet2016-11-01T18:23:41Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida e instalação de Sistema Operacional de forma automatizada.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts, isto se tornará trivial.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Lab.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Puppet Server ===<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
=== Instalação e configuração do Cliente ===<br />
<br />
Aqui vamos instalar o puppet no cliente “puppetclient-01.devopslab.com.br”.<br />
Faça o login no host cliente (puppetclient-01.devopslab.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
#rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
<br />
#yum -y install puppet-agent<br />
</syntaxhighlight ><br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
#source /etc/profile.d/puppet-agent.sh<br />
Edite o puppet.conf e aponte para o server Puppet Server.<br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
systemctl enable puppet.service<br />
systemctl start puppet.service<br />
Rode o puppet pela primeira vez.<br />
#puppet agent -t<br />
Exiting; no certificate found and waitforcert is disabled<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
#puppet cert list<br />
root@puppetserver-01 ~]# puppet cert list<br />
"puppetclient-01.devopslab.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
Assinatura do certificado.<br />
[root@puppetserver-01 ~]# puppet cert sign puppetclient-01.devopslab.com.br<br />
Notice: Signed certificate request for puppetclient-01.devopslab.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest puppetclient-01.devopslab.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/puppetclient-01.devopslab.com.br.pem'<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
[root@puppetclient-01 ~]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
==== Criação de módulos de configuração ====<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada. Criação de módulos é um assunto extenso, existem várias maneiras de fazer a mesma coisa, das simples as mais complexas, aqui vamos utilizar apenas a forma mais recomendada.<br />
No PUPPET SERVER<br />
#puppet module generate<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
#puppet module generate devopslab-edithosts --skip-interview<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
#cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
#vi hosts.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
20<br />
21<br />
22<br />
23<br />
24<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
#puppet parser validate hosts.pp<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
#vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
node <br />
'puppetclient-01.devopslab.com.br',<br />
'puppetclient-02.devopslab.com.br',<br />
'puppetclient-03.devopslab.com.br',<br />
'puppetclient-04.devopslab.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
}<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
Verificando as alterações no /etc/hosts.<br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
10.0.0.161 puppetclient-01.devopslab.com.br puppetclient-01<br />
10.0.0.160 puppetserver-01.devopslab.com.br puppetserver-01<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
#cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
#vi pacotes.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
#vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
[root@puppetclient-01 /]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3176Puppet2016-11-01T18:19:22Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida e instalação de Sistema Operacional de forma automatizada.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts, isto se tornará trivial.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
=== Infraestrutura do ambiente ===<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Lab.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
==== Pré-requisitos ====<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
</syntaxhighlight ><br />
<br />
<br />
==== Instalação dos repositórios ====<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
==== Instalação e configuração do Puppet Server ====<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppet.service<br />
# systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
= Instalação e configuração do Cliente<br />
<br />
Aqui vamos instalar o puppet no cliente “puppetclient-01.devopslab.com.br”.<br />
Faça o login no host cliente (puppetclient-01.devopslab.com.br) e instale o repositório e o Puppet agent.<br />
<syntaxhighlight lang="console" ><br />
#rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
<br />
#yum -y install puppet-agent<br />
<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
#source /etc/profile.d/puppet-agent.sh<br />
Edite o puppet.conf e aponte para o server Puppet Server.<br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
systemctl enable puppet.service<br />
systemctl start puppet.service<br />
Rode o puppet pela primeira vez.<br />
#puppet agent -t<br />
Exiting; no certificate found and waitforcert is disabled<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
#puppet cert list<br />
root@puppetserver-01 ~]# puppet cert list<br />
"puppetclient-01.devopslab.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
Assinatura do certificado.<br />
[root@puppetserver-01 ~]# puppet cert sign puppetclient-01.devopslab.com.br<br />
Notice: Signed certificate request for puppetclient-01.devopslab.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest puppetclient-01.devopslab.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/puppetclient-01.devopslab.com.br.pem'<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
[root@puppetclient-01 ~]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
<br />
==== Criação de módulos de configuração ====<br />
===== Módulo 1 – Edição do arquivo /etc/hosts =====<br />
<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada. Criação de módulos é um assunto extenso, existem várias maneiras de fazer a mesma coisa, das simples as mais complexas, aqui vamos utilizar apenas a forma mais recomendada.<br />
No PUPPET SERVER<br />
#puppet module generate<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
#puppet module generate devopslab-edithosts --skip-interview<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
#cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
#vi hosts.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
20<br />
21<br />
22<br />
23<br />
24<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
#puppet parser validate hosts.pp<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
#vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
node <br />
'puppetclient-01.devopslab.com.br',<br />
'puppetclient-02.devopslab.com.br',<br />
'puppetclient-03.devopslab.com.br',<br />
'puppetclient-04.devopslab.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
}<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
Verificando as alterações no /etc/hosts.<br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
10.0.0.161 puppetclient-01.devopslab.com.br puppetclient-01<br />
10.0.0.160 puppetserver-01.devopslab.com.br puppetserver-01<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
#cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
#vi pacotes.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
#vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
[root@puppetclient-01 /]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3175Puppet2016-11-01T18:07:56Z<p>Edson.rodrigues: /* Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração */</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida e instalação de Sistema Operacional de forma automatizada.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts, isto se tornará trivial.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
'''1. Infraestrutura do ambiente'''<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Lab.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
'''2. Pré-requisitos'''<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
</syntaxhighlight ><br />
<br />
<br />
'''3. Instalação dos repositórios'''<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
'''4. Instalação e configuração do Puppet Server'''<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" ><br />
#systemctl start puppet.service<br />
#systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<syntaxhighlight lang="console" ><br />
# puppet agent -t<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
</syntaxhighlight ><br />
<br />
Libere a porta 8140/tcp no Firewall<br />
firewall-cmd --permanent --add-port=8140/tcp<br />
systemctl reload firewalld<br />
5. Instalação e configuração do Cliente<br />
Aqui vamos instalar o puppet no cliente “puppetclient-01.devopslab.com.br”.<br />
Faça o login no host cliente (puppetclient-01.devopslab.com.br) e instale o repositório e o Puppet agent.<br />
#rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
<br />
#yum -y install puppet-agent<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
#source /etc/profile.d/puppet-agent.sh<br />
Edite o puppet.conf e aponte para o server Puppet Server.<br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
systemctl enable puppet.service<br />
systemctl start puppet.service<br />
Rode o puppet pela primeira vez.<br />
#puppet agent -t<br />
Exiting; no certificate found and waitforcert is disabled<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
#puppet cert list<br />
root@puppetserver-01 ~]# puppet cert list<br />
"puppetclient-01.devopslab.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
Assinatura do certificado.<br />
[root@puppetserver-01 ~]# puppet cert sign puppetclient-01.devopslab.com.br<br />
Notice: Signed certificate request for puppetclient-01.devopslab.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest puppetclient-01.devopslab.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/puppetclient-01.devopslab.com.br.pem'<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
[root@puppetclient-01 ~]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
6. Criação de módulos de configuração<br />
6.1 – Módulo 1 – Edição do arquivo /etc/hosts<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada. Criação de módulos é um assunto extenso, existem várias maneiras de fazer a mesma coisa, das simples as mais complexas, aqui vamos utilizar apenas a forma mais recomendada.<br />
No PUPPET SERVER<br />
#puppet module generate<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
#puppet module generate devopslab-edithosts --skip-interview<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
#cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
#vi hosts.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
20<br />
21<br />
22<br />
23<br />
24<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
#puppet parser validate hosts.pp<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
#vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
node <br />
'puppetclient-01.devopslab.com.br',<br />
'puppetclient-02.devopslab.com.br',<br />
'puppetclient-03.devopslab.com.br',<br />
'puppetclient-04.devopslab.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
}<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
Verificando as alterações no /etc/hosts.<br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
10.0.0.161 puppetclient-01.devopslab.com.br puppetclient-01<br />
10.0.0.160 puppetserver-01.devopslab.com.br puppetserver-01<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
#cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
#vi pacotes.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
#vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
[root@puppetclient-01 /]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3174Puppet2016-11-01T18:04:56Z<p>Edson.rodrigues: /* Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração */</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.'''<br />
<br />
'''''Introdução.'''''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida e instalação de Sistema Operacional de forma automatizada.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts, isto se tornará trivial.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
'''1. Infraestrutura do ambiente'''<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Lab.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
'''2. Pré-requisitos'''<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" line="1" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
</syntaxhighlight ><br />
<br />
<br />
'''3. Instalação dos repositórios'''<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" line="1" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
'''4. Instalação e configuração do Puppet Server'''<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" line="1" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" line="1" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" line="1" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" line="1" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" line="1" ><br />
#systemctl start puppet.service<br />
#systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
Libere a porta 8140/tcp no Firewall<br />
firewall-cmd --permanent --add-port=8140/tcp<br />
systemctl reload firewalld<br />
5. Instalação e configuração do Cliente<br />
Aqui vamos instalar o puppet no cliente “puppetclient-01.devopslab.com.br”.<br />
Faça o login no host cliente (puppetclient-01.devopslab.com.br) e instale o repositório e o Puppet agent.<br />
#rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
<br />
#yum -y install puppet-agent<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
#source /etc/profile.d/puppet-agent.sh<br />
Edite o puppet.conf e aponte para o server Puppet Server.<br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
systemctl enable puppet.service<br />
systemctl start puppet.service<br />
Rode o puppet pela primeira vez.<br />
#puppet agent -t<br />
Exiting; no certificate found and waitforcert is disabled<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
#puppet cert list<br />
root@puppetserver-01 ~]# puppet cert list<br />
"puppetclient-01.devopslab.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
Assinatura do certificado.<br />
[root@puppetserver-01 ~]# puppet cert sign puppetclient-01.devopslab.com.br<br />
Notice: Signed certificate request for puppetclient-01.devopslab.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest puppetclient-01.devopslab.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/puppetclient-01.devopslab.com.br.pem'<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
[root@puppetclient-01 ~]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
6. Criação de módulos de configuração<br />
6.1 – Módulo 1 – Edição do arquivo /etc/hosts<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada. Criação de módulos é um assunto extenso, existem várias maneiras de fazer a mesma coisa, das simples as mais complexas, aqui vamos utilizar apenas a forma mais recomendada.<br />
No PUPPET SERVER<br />
#puppet module generate<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
#puppet module generate devopslab-edithosts --skip-interview<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
#cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
#vi hosts.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
20<br />
21<br />
22<br />
23<br />
24<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
#puppet parser validate hosts.pp<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
#vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
node <br />
'puppetclient-01.devopslab.com.br',<br />
'puppetclient-02.devopslab.com.br',<br />
'puppetclient-03.devopslab.com.br',<br />
'puppetclient-04.devopslab.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
}<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
Verificando as alterações no /etc/hosts.<br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
10.0.0.161 puppetclient-01.devopslab.com.br puppetclient-01<br />
10.0.0.160 puppetserver-01.devopslab.com.br puppetserver-01<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
#cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
#vi pacotes.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
#vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
[root@puppetclient-01 /]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3173Puppet2016-11-01T18:04:16Z<p>Edson.rodrigues: /* Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração */</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.<br />
Introdução.'''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida e instalação de Sistema Operacional de forma automatizada.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts, isto se tornará trivial.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
'''1. Infraestrutura do ambiente'''<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Lab.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
'''2. Pré-requisitos'''<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" line="1" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
</syntaxhighlight ><br />
<br />
<br />
'''3. Instalação dos repositórios'''<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" line="1" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
'''4. Instalação e configuração do Puppet Server'''<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" line="1" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" line="1" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" line="1" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" line="1" ><br />
# vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppet.mstech.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" line="1" ><br />
#systemctl start puppet.service<br />
#systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
Libere a porta 8140/tcp no Firewall<br />
firewall-cmd --permanent --add-port=8140/tcp<br />
systemctl reload firewalld<br />
5. Instalação e configuração do Cliente<br />
Aqui vamos instalar o puppet no cliente “puppetclient-01.devopslab.com.br”.<br />
Faça o login no host cliente (puppetclient-01.devopslab.com.br) e instale o repositório e o Puppet agent.<br />
#rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
<br />
#yum -y install puppet-agent<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
#source /etc/profile.d/puppet-agent.sh<br />
Edite o puppet.conf e aponte para o server Puppet Server.<br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
systemctl enable puppet.service<br />
systemctl start puppet.service<br />
Rode o puppet pela primeira vez.<br />
#puppet agent -t<br />
Exiting; no certificate found and waitforcert is disabled<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
#puppet cert list<br />
root@puppetserver-01 ~]# puppet cert list<br />
"puppetclient-01.devopslab.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
Assinatura do certificado.<br />
[root@puppetserver-01 ~]# puppet cert sign puppetclient-01.devopslab.com.br<br />
Notice: Signed certificate request for puppetclient-01.devopslab.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest puppetclient-01.devopslab.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/puppetclient-01.devopslab.com.br.pem'<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
[root@puppetclient-01 ~]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
6. Criação de módulos de configuração<br />
6.1 – Módulo 1 – Edição do arquivo /etc/hosts<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada. Criação de módulos é um assunto extenso, existem várias maneiras de fazer a mesma coisa, das simples as mais complexas, aqui vamos utilizar apenas a forma mais recomendada.<br />
No PUPPET SERVER<br />
#puppet module generate<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
#puppet module generate devopslab-edithosts --skip-interview<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
#cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
#vi hosts.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
20<br />
21<br />
22<br />
23<br />
24<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
#puppet parser validate hosts.pp<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
#vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
node <br />
'puppetclient-01.devopslab.com.br',<br />
'puppetclient-02.devopslab.com.br',<br />
'puppetclient-03.devopslab.com.br',<br />
'puppetclient-04.devopslab.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
}<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
Verificando as alterações no /etc/hosts.<br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
10.0.0.161 puppetclient-01.devopslab.com.br puppetclient-01<br />
10.0.0.160 puppetserver-01.devopslab.com.br puppetserver-01<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
#cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
#vi pacotes.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
#vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
[root@puppetclient-01 /]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3172Puppet2016-11-01T18:00:27Z<p>Edson.rodrigues: /* Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração */</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.<br />
Introdução.'''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida e instalação de Sistema Operacional de forma automatizada.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts, isto se tornará trivial.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
'''1. Infraestrutura do ambiente'''<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Lab.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
'''2. Pré-requisitos'''<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" line="1" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
</syntaxhighlight ><br />
<br />
<br />
'''3. Instalação dos repositórios'''<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" line="1" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
'''4. Instalação e configuração do Puppet Server'''<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" line="1" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" line="1" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" line="1" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" line="1" ><br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" line="1" ><br />
#systemctl start puppet.service<br />
#systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
Libere a porta 8140/tcp no Firewall<br />
firewall-cmd --permanent --add-port=8140/tcp<br />
systemctl reload firewalld<br />
5. Instalação e configuração do Cliente<br />
Aqui vamos instalar o puppet no cliente “puppetclient-01.devopslab.com.br”.<br />
Faça o login no host cliente (puppetclient-01.devopslab.com.br) e instale o repositório e o Puppet agent.<br />
#rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
<br />
#yum -y install puppet-agent<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
#source /etc/profile.d/puppet-agent.sh<br />
Edite o puppet.conf e aponte para o server Puppet Server.<br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
systemctl enable puppet.service<br />
systemctl start puppet.service<br />
Rode o puppet pela primeira vez.<br />
#puppet agent -t<br />
Exiting; no certificate found and waitforcert is disabled<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
#puppet cert list<br />
root@puppetserver-01 ~]# puppet cert list<br />
"puppetclient-01.devopslab.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
Assinatura do certificado.<br />
[root@puppetserver-01 ~]# puppet cert sign puppetclient-01.devopslab.com.br<br />
Notice: Signed certificate request for puppetclient-01.devopslab.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest puppetclient-01.devopslab.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/puppetclient-01.devopslab.com.br.pem'<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
[root@puppetclient-01 ~]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
6. Criação de módulos de configuração<br />
6.1 – Módulo 1 – Edição do arquivo /etc/hosts<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada. Criação de módulos é um assunto extenso, existem várias maneiras de fazer a mesma coisa, das simples as mais complexas, aqui vamos utilizar apenas a forma mais recomendada.<br />
No PUPPET SERVER<br />
#puppet module generate<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
#puppet module generate devopslab-edithosts --skip-interview<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
#cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
#vi hosts.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
20<br />
21<br />
22<br />
23<br />
24<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
#puppet parser validate hosts.pp<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
#vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
node <br />
'puppetclient-01.devopslab.com.br',<br />
'puppetclient-02.devopslab.com.br',<br />
'puppetclient-03.devopslab.com.br',<br />
'puppetclient-04.devopslab.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
}<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
Verificando as alterações no /etc/hosts.<br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
10.0.0.161 puppetclient-01.devopslab.com.br puppetclient-01<br />
10.0.0.160 puppetserver-01.devopslab.com.br puppetserver-01<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
#cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
#vi pacotes.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
#vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
[root@puppetclient-01 /]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3171Puppet2016-11-01T17:59:22Z<p>Edson.rodrigues: </p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.<br />
Introdução.'''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida e instalação de Sistema Operacional de forma automatizada.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts, isto se tornará trivial.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
'''1. Infraestrutura do ambiente'''<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Lab.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
'''2. Pré-requisitos'''<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" line="1" ><br />
# cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
</syntaxhighlight ><br />
<br />
<br />
'''3. Instalação dos repositórios'''<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" line="1" ><br />
# rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
'''4. Instalação e configuração do Puppet Server'''<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" line="1" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
'''Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/'''<br />
<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" line="1" ><br />
# vi /etc/sysconfig/puppetserver<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" line="1" ><br />
# systemctl start puppetserver.service<br />
# systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<syntaxhighlight lang="console" line="1" ><br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
</syntaxhighlight ><br />
<syntaxhighlight lang="console" line="1" ><br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
</syntaxhighlight ><br />
<br />
Inicie e ative o Puppet Agent.<br />
<syntaxhighlight lang="console" line="1" ><br />
#systemctl start puppet.service<br />
#systemctl enable puppet.service<br />
</syntaxhighlight ><br />
<br />
'''Gere o certificado SSL do agente.'''<br />
<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
Libere a porta 8140/tcp no Firewall<br />
firewall-cmd --permanent --add-port=8140/tcp<br />
systemctl reload firewalld<br />
5. Instalação e configuração do Cliente<br />
Aqui vamos instalar o puppet no cliente “puppetclient-01.devopslab.com.br”.<br />
Faça o login no host cliente (puppetclient-01.devopslab.com.br) e instale o repositório e o Puppet agent.<br />
#rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
<br />
#yum -y install puppet-agent<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
#source /etc/profile.d/puppet-agent.sh<br />
Edite o puppet.conf e aponte para o server Puppet Server.<br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
systemctl enable puppet.service<br />
systemctl start puppet.service<br />
Rode o puppet pela primeira vez.<br />
#puppet agent -t<br />
Exiting; no certificate found and waitforcert is disabled<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
#puppet cert list<br />
root@puppetserver-01 ~]# puppet cert list<br />
"puppetclient-01.devopslab.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
Assinatura do certificado.<br />
[root@puppetserver-01 ~]# puppet cert sign puppetclient-01.devopslab.com.br<br />
Notice: Signed certificate request for puppetclient-01.devopslab.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest puppetclient-01.devopslab.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/puppetclient-01.devopslab.com.br.pem'<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
[root@puppetclient-01 ~]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
6. Criação de módulos de configuração<br />
6.1 – Módulo 1 – Edição do arquivo /etc/hosts<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada. Criação de módulos é um assunto extenso, existem várias maneiras de fazer a mesma coisa, das simples as mais complexas, aqui vamos utilizar apenas a forma mais recomendada.<br />
No PUPPET SERVER<br />
#puppet module generate<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
#puppet module generate devopslab-edithosts --skip-interview<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
#cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
#vi hosts.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
20<br />
21<br />
22<br />
23<br />
24<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
#puppet parser validate hosts.pp<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
#vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
node <br />
'puppetclient-01.devopslab.com.br',<br />
'puppetclient-02.devopslab.com.br',<br />
'puppetclient-03.devopslab.com.br',<br />
'puppetclient-04.devopslab.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
}<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
Verificando as alterações no /etc/hosts.<br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
10.0.0.161 puppetclient-01.devopslab.com.br puppetclient-01<br />
10.0.0.160 puppetserver-01.devopslab.com.br puppetserver-01<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
#cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
#vi pacotes.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
#vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
[root@puppetclient-01 /]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Puppet&diff=3170Puppet2016-11-01T17:54:17Z<p>Edson.rodrigues: Criou página com ' == Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração == '''Neste tutorial nós vamos instalar e configurar o Puppet Server,...'</p>
<hr />
<div><br />
== Puppet – Como instalar e configurar o Puppet Server, Puppet Cliente e Módulos de Configuração ==<br />
<br />
'''Neste tutorial nós vamos instalar e configurar o Puppet Server, instalar o Puppet nos clientes e criar os módulos de configuração do Puppet.<br />
Introdução.'''<br />
<br />
O Puppet é uma ferramenta que permite a gerência e configuração de arquivos ou aplicações, na prática isto quer dizer que você consegue manter seu parque de hosts (desktops e servidores) com arquivos de configuração padronizados, pacotes e aplicativos atualizados, permite a gestão de usuários, monitoração de aplicações, aplicação de mudanças no ambiente de forma rápida e instalação de Sistema Operacional de forma automatizada.<br />
<br />
Puppet também faz Orquestração, ou seja você consegue executar comandos em vários servidores ao mesmo tempo, por exemplo saiu um bug e você precisa atualizar um pacote rapidamente, com a Orquestração do Puppet isto é fácil e rápido, não importa o número de hosts, isto se tornará trivial.<br />
<br />
Puppet conta também com o Facter, que permite colher qualquer informação dos hosts, como detalhes do hardware e software instalados, ele atua como uma “ferramenta de inventário”.<br />
A comunidade do Puppet é gigantesca, conta com grande quantidade de contribuições, muitos plug-ins, módulos, vasta documentação e inúmeras listas e sites de discussão.<br />
<br />
Vamos lá.<br />
<br />
'''1. Infraestrutura do ambiente'''<br />
<br />
Tenha pelo menos 1 VM para o Puppet Master 1 VM para ser o cliente.<br />
<br />
Utilizado neste Lab.<br />
Sistema Operacional Centos 7 64 bits – instalação mínima e atualizada.<br />
1 x Puppet Server (Puppet Master) – puppet.mstech.com.br (192.168.13.42)<br />
1 x Puppet Client – agente-puppet.mstech.com.br (192.168.11.11)<br />
<br />
'''2. Pré-requisitos'''<br />
<br />
Todos os servidores e clientes devem estar com o hostname padronizado da seguinte forma: nome_hostname.dominio.com.br nome_hostname.<br />
<syntaxhighlight lang="console" line="1" ><br />
#cat /etc/hosts<br />
192.168.11.11 puppet.mstech.com.br puppet<br />
</syntaxhighlight ><br />
<br />
<br />
'''3. Instalação dos repositórios'''<br />
<br />
Instalar o repositório puppet tanto no Puppet Server como nos clientes.<br />
<syntaxhighlight lang="console" line="1" ><br />
#rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
</syntaxhighlight ><br />
<br />
Para outras Versões de Centos/Red-Hat, Debian/Ubuntu, Suse consulte: http://docs.puppetlabs.com/guides/puppetlabs_package_repositories.html<br />
<br />
'''4. Instalação e configuração do Puppet Server'''<br />
<br />
Junto do pacote puppetserver, também será instalado o puppetclient.<br />
<br />
<syntaxhighlight lang="console" line="1" ><br />
# yum install puppetserver<br />
</syntaxhighlight ><br />
<br />
Por padrão o Puppet vem com o JVM (java) configurado para subir utilizando 2GB RAM, que é o mínimo recomendado, porém se o seu servidor não dispor desta memória, altere a configuração da JVM conforme a sua necessidade.<br />
Adicional: Dê uma olhada no tópico Tuning do Puppet http://devopslab.com.br/tuning-do-puppet-server/<br />
Altere a linha “JAVA_ARGS”.<br />
<syntaxhighlight lang="console" line="1" ><br />
#vi /etc/sysconfig/puppetserver<br />
<br />
JAVA_ARGS="-Xms1g –Xmx1g -XX:MaxPermSize=256m"<br />
</syntaxhighlight ><br />
<br />
'''Inicie o Puppet server e habilite o startup automático.'''<br />
<syntaxhighlight lang="console" line="1" ><br />
#systemctl start puppetserver.service<br />
#systemctl enable puppetserver.service<br />
</syntaxhighlight ><br />
<br />
'''Configure o puppet agente.'''<br />
<br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Inicie e ative o Puppet Agent.<br />
#systemctl start puppet.service<br />
#systemctl enable puppet.service<br />
Gere o certificado SSL do agente.<br />
#puppet agent -t<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetserver-01.devopslab.com.br<br />
Info: Applying configuration version '1455913339'<br />
Info: Creating state file /opt/puppetlabs/puppet/cache/state/state.yaml<br />
Notice: Applied catalog in 0.01 seconds<br />
Libere a porta 8140/tcp no Firewall<br />
firewall-cmd --permanent --add-port=8140/tcp<br />
systemctl reload firewalld<br />
5. Instalação e configuração do Cliente<br />
Aqui vamos instalar o puppet no cliente “puppetclient-01.devopslab.com.br”.<br />
Faça o login no host cliente (puppetclient-01.devopslab.com.br) e instale o repositório e o Puppet agent.<br />
#rpm -hiv https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm<br />
<br />
#yum -y install puppet-agent<br />
Não inicie o puppet ainda.<br />
Carregue o PATH do puppet para incluir os comandos do puppet. Isto deveria ser automático e acontece apenas neste versão, possívelmente será corrigido em novas versões do puppet cliente.<br />
#source /etc/profile.d/puppet-agent.sh<br />
Edite o puppet.conf e aponte para o server Puppet Server.<br />
#vi /etc/puppetlabs/puppet/puppet.conf<br />
<br />
[agent]<br />
server = puppetserver-01.devopslab.com.br<br />
Agora inicie e ative o startup automático do Puppet agent.<br />
systemctl enable puppet.service<br />
systemctl start puppet.service<br />
Rode o puppet pela primeira vez.<br />
#puppet agent -t<br />
Exiting; no certificate found and waitforcert is disabled<br />
O puppet cliente vai fazer uma solicitação de assinatura de certificado (CSR) para o Puppet Server (CA). Na verdade já foi feito a solicitação no start do puppet agent, porém é recomendável verificar novamente com o comando “puppet agente –t”.<br />
Se logue no Puppet Server e assine o certificado solicitado pelo Puppet client.<br />
Puppet Server puppetserver-01.devopslab.com.br<br />
#puppet cert list<br />
root@puppetserver-01 ~]# puppet cert list<br />
"puppetclient-01.devopslab.com.br" (SHA256) 73:66:B0:FE:4F:96:E6:4B:D8:7B:8E:B3:F5:72:41:<br />
68:83:50:F3:4C:09:5A:1G:68:F0:47:10:28:6D:11:42:84<br />
Assinatura do certificado.<br />
[root@puppetserver-01 ~]# puppet cert sign puppetclient-01.devopslab.com.br<br />
Notice: Signed certificate request for puppetclient-01.devopslab.com.br<br />
Notice: Removing file Puppet::SSL::CertificateRequest puppetclient-01.devopslab.com.br at <br />
'/etc/puppetlabs/puppet/ssl/ca/requests/puppetclient-01.devopslab.com.br.pem'<br />
Volte para o cliente “puppetclient-01.devopslab.com.br” e rode novamente o “puppet agente –t”.<br />
[root@puppetclient-01 ~]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455912908'<br />
Notice: Applied catalog in 0.03 seconds<br />
Pronto! Puppet Server e Puppet client (Cliente) funcionando.<br />
Agora falta apenas criar módulos e ver o puppet aplicando as configurações desejadas.<br />
6. Criação de módulos de configuração<br />
6.1 – Módulo 1 – Edição do arquivo /etc/hosts<br />
Vamos criar um módulo para editar arquivo de hosts de forma automática via puppet.<br />
Vamos usar o comando “puppet module generate”, é a forma mais “difícil” porém é a recomendada pela Puppetlabs e também mais organizada. Criação de módulos é um assunto extenso, existem várias maneiras de fazer a mesma coisa, das simples as mais complexas, aqui vamos utilizar apenas a forma mais recomendada.<br />
No PUPPET SERVER<br />
#puppet module generate<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
#puppet module generate devopslab-edithosts --skip-interview<br />
Acabamos de criar um módulo devopslab-edithosts.<br />
A opção “–skip-interview” pula uma série de perguntas como nome do criador do módulo, versão do módulo, descrição e etc, para o nosso caso não precisa, mas você pode dar uma olhada depois.<br />
Vamos criar nosso manifesto, ou seja definir uma classe.<br />
#cd /etc/puppetlabs/code/environments/production/modules/edithosts/manifests<br />
#vi hosts.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
20<br />
21<br />
22<br />
23<br />
24<br />
class edithosts::hosts {<br />
<br />
###A linha comment e opcional###<br />
host { 'crm.devopslab.com.br':<br />
ip => '10.0.10.10',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'portal.devopslab.com.br':<br />
ip => '10.0.10.11',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'wiki.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
host { 'webmail.devopslab.com.br':<br />
ip => '10.0.10.13',<br />
comment => 'Adicionado via Puppet'<br />
}<br />
<br />
}<br />
Onde “edithosts” é o nome do módulo, e “hosts” o nome do manifesto.<br />
Verifique se tem algum erro no manifesto.<br />
#puppet parser validate hosts.pp<br />
Vamos criar a definição do node (node são os clientes rodando o puppet client, são seus hosts no geral).<br />
cd /etc/puppetlabs/code/environments/production/manifests<br />
<br />
#vi site.pp<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
}<br />
E seu eu tiver mais de 1 node?. Simplesmente faça assim:<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
node <br />
'puppetclient-01.devopslab.com.br',<br />
'puppetclient-02.devopslab.com.br',<br />
'puppetclient-03.devopslab.com.br',<br />
'puppetclient-04.devopslab.com.br'<br />
## assim por diante.<br />
{<br />
include edithosts::hosts<br />
}<br />
Valide a configuração site.pp no intuito de achar erros.<br />
puppet parser validate site.pp<br />
No PUPPET CLIENT (Node/Cliente).<br />
Logue no Puppet Cliente e rode o “puppet agente –t”.<br />
# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455919826'<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[crm.devopslab.com.br]/ensure: created<br />
Info: Computing checksum on file /etc/hosts<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[portal.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[wiki.devopslab.com.br]/ensure: created<br />
Notice: /Stage[main]/Edithosts::Hosts/Host[webmail.devopslab.com.br]/ensure: created<br />
Notice: Applied catalog in 0.05 seconds<br />
Verificando as alterações no /etc/hosts.<br />
# cat /etc/hosts<br />
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4<br />
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6<br />
<br />
10.0.0.161 puppetclient-01.devopslab.com.br puppetclient-01<br />
10.0.0.160 puppetserver-01.devopslab.com.br puppetserver-01<br />
10.0.10.10 crm.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.11 portal.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 wiki.devopslab.com.br # Adicionado via Puppet<br />
10.0.10.13 webmail.devopslab.com.br # Adicionado via Puppet<br />
Perceba que o arquivo de hosts foi editado automaticamente.<br />
6.2 – Módulo 2 – Instalação pacotes, remoção, desativação e update de pacotes<br />
Vou criar um módulo checklist, que vai instalar alguns pacotes, remover os desnecessários, e manter outros atualizados, bem checklist mesmo, toda empresa tem.<br />
Checklist<br />
Telnet – Instalar<br />
Openssh – Manter atualizado na última versão.<br />
Gnutils – Manter atualizado na última versão.<br />
Vim – Remover<br />
No PUPPET SERVER.<br />
Criação do módulo de checklist “devopslab-checklist”.<br />
#cd /etc/puppetlabs/code/environments/production/modules<br />
puppet module generate devopslab-checklist --skip-interview<br />
Criação do manifesto.<br />
#cd /etc/puppetlabs/code/environments/production/modules/checklist/manifests<br />
#vi pacotes.pp<br />
1<br />
2<br />
3<br />
4<br />
5<br />
6<br />
7<br />
8<br />
9<br />
10<br />
11<br />
12<br />
13<br />
14<br />
15<br />
16<br />
17<br />
18<br />
19<br />
class checklist::pacotes {<br />
<br />
package { [ 'telnet' ]:<br />
ensure => present,<br />
}<br />
<br />
package { [ 'openssh' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'gnutls' ]:<br />
ensure => latest,<br />
}<br />
<br />
package { [ 'vim' ]:<br />
ensure => absent,<br />
}<br />
<br />
}<br />
Vamos criar a definição do node. Nós já criamos anteriormente, vamos apenas adicionar um include para o novo manifesto.<br />
#vi /etc/puppetlabs/code/environments/production/manifests/site.pp<br />
<br />
node 'puppetclient-01.devopslab.com.br' {<br />
include edithosts::hosts<br />
include checklist::pacotes<br />
}<br />
No PUPPET CLIENT. Logue no cliente e rode o “puppet agente –t”.<br />
[root@puppetclient-01 /]# puppet agent -t<br />
Info: Using configured environment 'production'<br />
Info: Retrieving pluginfacts<br />
Info: Retrieving plugin<br />
Info: Loading facts<br />
Info: Caching catalog for puppetclient-01.devopslab.com.br<br />
Info: Applying configuration version '1455975217'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[telnet]/ensure: created<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[gnutls]/ensure: ensure changed '3.3.8-12.el7_1.1' to '0:3.3.8-14.el7_2'<br />
Notice: /Stage[main]/Checklist::Pacotes/Package[vim]/ensure: removed<br />
Notice: Applied catalog in 8.23 seconds<br />
Perceba que não aparece nada sobre o openssh, pois ele já está atualizado, então o Puppet sabiamente ignora.<br />
Finalizamos a instalação do Puppet server e cliente assim como a criação e aplicação de módulos de configuração.<br />
Em outro tópico vou demonstrar como fazer a Orquestração com o Puppet e instalar o Plugin Facter para colher informações dos hosts.<br />
Lembrando que a criação de módulos no Puppet é uma ciência, as possibilidades e otimizações são infinitas, dá para brincar bastante, o intuito deste tópico foi apenas fazer uma introdução, porém passe sempre aqui que postarei muitas coisas legais.<br />
Obrigado</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Devops&diff=3169Devops2016-11-01T17:30:11Z<p>Edson.rodrigues: </p>
<hr />
<div>__FORCETOC__<br />
== Sobre o DevOps ==<br />
[[Arquivo:DevOps2.png|right|100px|caption]]<br />
'''''DevOps''''', é uma cultura de desenvolvimento de software que explora a comunicação, colaboração e integração entre desenvolvedores de software e profissionais de TI.<br />Com o objetivo de realizar a implantação padronizada de nossos sistemas, os profissionais buscam apoiar o desenvolvimento para minimizar a ocorrência de falhas e indisponibilidades, visando a qualidade nos serviços implantados.<br />
<br />
== Documentos ==<br />
<br />
* [[Atualização de pacote WEB pelo IIS]]<br />
* [[Backup de banco de dados]]<br />
* [[Restore de banco de dados]]<br />
* [[Publicação de relatórios utilizando o Reporting Services]]<br />
* [[Modificando o arquivo HOSTS]]<br />
* [[Erro ao efetuar upload de arquivo Access em site (INCIDENTE)]]<br />
* [[Criando VM´s com Vagrant]]<br />
* [[Erro ao abrir a página - Server Error in '/' Application (INCIDENTE)]]<br />
* [[Manipulando VM´s com scripts PowerShell]]<br />
* [[Scripts SQL]]<br />
* [[Puppet]]</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Trilha_NoSQL&diff=1551Trilha NoSQL2016-07-19T12:05:35Z<p>Edson.rodrigues: Criou página com 'Infelizmente minha participação no TDC – SP não foi de muita satisfação para meu aprendizado com as ferramentas apresentadas, mas como já trabalhamos com um banco NoSQ...'</p>
<hr />
<div>Infelizmente minha participação no TDC – SP não foi de muita satisfação para meu aprendizado com as ferramentas apresentadas, mas como já trabalhamos com um banco NoSQL, vou explicar a instalação e configuração do MongoDB e inclusive a configuração para réplica.<br />
<br />
<br />
Instalação do MongoDB em um servidor Centos 7.<br />
<br />
Para realizar a instalação do mongo primeiro crie um arquivo no diretório /etc/yum.repos.d/ com o nome de mongodb-org-3.0.repo com o seguinte comando:<br />
<br />
sudo vi /etc/yum.repos.d/mongodb-org-3.0.repo<br />
<br />
digite a senha de root.<br />
<br />
Use o seguinte arquivo de repositório para especificar a última versão estável do MongoDB:<br />
<br />
[mongodb-org-3.0]<br />
name=MongoDB Repository<br />
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.0/x86_64/<br />
gpgcheck=0<br />
enabled=1<br />
Para utilizar a opção copiar e colar no terminal do vi pressione “i” para entrar no modo de inserção e então pressione as teclas Ctrl+Shift+v para colar o texto acima, em seguida aperte Esc para sair do modo de inserção e as Shift+”:” e “wq” para sair e salvar o arquivo.<br />
<br />
Então vamos agora atualizar o repositório e instalar o MongoDB com o yum, execute:<br />
<br />
sudo yum update & sudo yum install -y mongodb-org<br />
<br />
Permita o acesso a porta 27017 (porta padrão do MongoDB) para o SELinux, para isso execute:<br />
<br />
semanage port -a -t mongod_port_t -p tcp 27017<br />
<br />
Caso ache necessário pode ser alterado as permissões do SELinux no arquivo de configuração do mesmo que se localiza no diretório /etc/selinux/config. <br />
<br />
Altere:<br />
<br />
SELINUX=enforcing<br />
<br />
para:<br />
<br />
SELINUX=permissive<br />
<br />
ou <br />
<br />
SELINUX=disabled.<br />
<br />
<br />
<br />
Reinicio o sistema com o sudo reboot, e agora iremos configurar o servidor.<br />
<br />
Edite o arquivo mongod.conf que se encontra no diretório /etc/ como o editor vi.<br />
<br />
sudo vi /etc/mongod.conf<br />
<br />
Obs.: para navegar nas linhas do vi utilize as letras do teclado:<br />
<br />
“j” = para ir para baixo<br />
“k” = para ir para cima<br />
“l” = para ir para diretia<br />
“h” = para ir para esquerda.<br />
<br />
pressione “i” para entrar no modo de edição e altere as seguintes linhas:<br />
<br />
bind_ip=127.0.0.1<br />
<br />
alterar para <br />
<br />
bind_ip=0.0.0.0<br />
<br />
e acrescente a seguinte linha:<br />
<br />
replSet=rs1 <br />
<br />
OBS.: Na versão 3.0.7 insira assim:<br />
<br />
replication:<br />
oplogSizeMB: 10240<br />
replSetName: "rs1"<br />
Pronto agora e só sair e salvar com as opções:<br />
<br />
Esc, Shift+”:” e “wq”<br />
<br />
Feito isso iremos colocar o mongo para iniciar junto como o sistema, execute:<br />
<br />
sudo chkconfig mongod on<br />
<br />
e inicie o Mongo:<br />
<br />
service mongod start.<br />
<br />
<br />
Obs.: Agora iremos configurar o servidor como primario para replicar em outros servidores, para isso iremos repetir todos os passos até aqui em outros servidores e só iremos diferenciar com os passos seguintes no servidor primário definido por você, então executaremos:<br />
<br />
mongod --replSet “rs1”<br />
<br />
onde “rs1” foi definido la no /etc/mongod.conf, e definiremos esse mesmo em todos os servidores.<br />
<br />
Iniciado o conjunto de réplicas no servidor primário execute:<br />
<br />
sudo mongo<br />
<br />
e <br />
<br />
E já dentro do editor do MongoDB execute:<br />
<br />
rs.initiate();<br />
<br />
Verifique a configuração inicial do conjunto de réplicas.<br />
Use rs.conf () para exibir o objeto de configuração do conjunto de réplicas:<br />
rs.conf();<br />
<br />
O objeto de configuração do conjunto de réplicas se assemelha ao seguinte:<br />
<br />
{<br />
"_id" : "rs1",<br />
"version" : 1,<br />
"members" : [<br />
{<br />
"_id" : 1,<br />
"host" : "mongodb0.example.net:27017"<br />
}<br />
]<br />
}<br />
Vamos agora adicionar os membros do conjunto de réplicas com o comando:<br />
<br />
rs.add(“192.168.0.1”);<br />
rs.add(“192.168.0.2”);<br />
<br />
E para o arbitrario execute:<br />
rs.addArb("192.168.11.219");<br />
<br />
Verifique o status do conjunto de réplicas.<br />
Use o comando:<br />
rs.status();<br />
<br />
{<br />
"info" : "run rs.initiate(...) if not yet done for the set",<br />
"ok" : 0,<br />
"errmsg" : "no replset config has been received",<br />
"code" : 94<br />
}<br />
Pronto, já está tudo configurado.<br />
Execute:<br />
exit<br />
para sair do mongo. <br />
<br />
Obs.: não esquecendo de realizar estes últimos passos somente no servidor primário.<br />
<br />
Para finalizar vá em cada servidor que receberá a replica do primario e execute:<br />
mongo <br />
e<br />
rs.slaveOk();<br />
<br />
Pronto.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Devops&diff=922Devops2016-06-29T17:27:14Z<p>Edson.rodrigues: /* Documentos */</p>
<hr />
<div>__FORCETOC__<br />
== Sobre o DevOps ==<br />
[[Arquivo:DevOps2.png|right|100px|caption]]<br />
'''''DevOps''''', é uma metodologia de desenvolvimento de software que explora a comunicação, colaboração e integração entre desenvolvedores de software e profissionais de TI.<br />Com o objetivo de realizar a implantação padronizada de nossos sistemas, os profissionais buscam apoiar o desenvolvimento para minimizar a ocorrência de falhas e indisponibilidades, visando a qualidade nos serviços implantados.<br />
<br />
<br />
== Documentos ==<br />
<br />
<br />
<EventCalendar><br />
namespace = Calendário<br />
</EventCalendar><br />
<br />
<br />
<syntaxhighlight lang="python" line="1" ><br />
def quickSort(arr):<br />
less = []<br />
pivotList = []<br />
more = []<br />
if len(arr) <= 1:<br />
return arr<br />
else:<br />
pass<br />
</syntaxhighlight></div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Arquivo:Exemplo.jpg&diff=623Arquivo:Exemplo.jpg2016-06-15T11:15:17Z<p>Edson.rodrigues: </p>
<hr />
<div></div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Devops&diff=622Devops2016-06-15T11:12:36Z<p>Edson.rodrigues: /* Documentos */</p>
<hr />
<div>__FORCETOC__<br />
== Sobre o DevOps ==<br />
[[Arquivo:DevOps2.png|right|100px|caption]]<br />
'''''DevOps''''', é uma metodologia de desenvolvimento de software que explora a comunicação, colaboração e integração entre desenvolvedores de software e profissionais de TI.<br />Com o objetivo de realizar a implantação padronizada de nossos sistemas, os profissionais buscam apoiar o desenvolvimento para minimizar a ocorrência de falhas e indisponibilidades, visando a qualidade nos serviços implantados.<br />
<br />
<br />
== Documentos ==<br />
[[Arquivo:Exemplo.jpg]]<br />
<br />
<EventCalendar><br />
namespace = Event<br />
</EventCalendar></div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Arquitetura_Classpad&diff=280Arquitetura Classpad2016-05-27T14:18:38Z<p>Edson.rodrigues: </p>
<hr />
<div>=Informações Gerais=<br />
<br />
== Ambientes utilizados ==<br />
{| class="wikitable"<br />
|-<br />
! Ambiente<br />
! URL de Acesso<br />
! Credenciais Admin<br />
|-<br />
| Desenvolvimento<br />
| http://dev-mscro.mstech.com.br<br />
| admin / 123456<br />
|-<br />
| Testes<br />
| http://tst-mscro.mstech.com.br<br />
| admin / ms@cro<br />
|-<br />
| Testes<br />
| http://tst-mscro.mstech.com.br<br />
| admin / ms@cro<br />
|-<br />
| Homologação Externa<br />
| http://hom-mscro.mstech.com.br<br />
| Informação exclusiva do Devops/GTI<br />
|-<br />
| Produção<br />
| http://mscro.mstech.com.br<br />
| Informação exclusiva do Devops/GTI<br />
|}<br />
<br />
== Repositório de Versionamento ==<br />
'''Ambiente:''' GITLab - Git<br />
<br />
'''Nome:''' MSCRO<br />
<br />
'''Caminho:''' https://gitlab.mstech.com.br/mscro/app-mscro.git<br />
<br />
'''Estrutura dos branches:''' Código mantido no tronco, porém mantemos 2 branches para os clientes SP e RJ.<br />
<br />
=Visão de Componentes=<br />
<br />
[[File:Classpad-escola.png]]<br />
<br />
=Decisões de Arquitetura=<br />
<br />
==== Persistência ====<br />
Através de banco de dados relacional<br />
Criação do banco de dados PostgreSQL nos servidores e em Realm nos dispositivos<br />
<br />
==== Tecnologia de integração ====<br />
Será realizada por meio de troca de mensagens entre os dispositivos e o servidor Datacenter e/ou servidor na escola<br />
Tráfego via WSS entre servidores e dispositivos<br />
Tráfego via HTTPS entre servidores e entre servidores e dispositivos<br />
<br />
==== Log ====<br />
Implementado log de negócio (para rastreabilidade das ações do usuário) e de log técnico para análise de funcionamento e falhas<br />
Para os logs utilizamos arquivos de texto gerenciado pelo LOG4J2<br />
Para crash report usaremos Crashlytics (Fabric.io) <br />
<br />
==== Padrão de arquitetura utilizado ====<br />
Utilizamos Servidores HTTPS RESTful na arquitetura JAX-RS para gerenciamento de APIs.<br />
Utilizamos o padrão de arquitetura DDD (Domain Driven Design) na aplicação web para ambiente de administração do servidor.<br />
Utilizamos o padrão “thin client” para os dispositivos. <br />
Utilizamos o padrão PubSub na comunicação durante uma sessão de aprendizagem<br />
Utilizamos o protocolo MDNS (Bonjour) para descoberta do servidor da escola<br />
Utilização de Jetty 9 para servidor HTTPS e WSS.<br />
Utilização de Hibernate 4 para comunicação com banco de dados PostgreSQL e SQLite.<br />
Utilização de JMDNS para Discovery na rede.<br />
<br />
==== Tecnologia de Front-end ====<br />
Utilização do design nativo Android<br />
Utilização de front end simplificado nos ambientes de Administração<br />
Aplicação de Material Design no Android e Angular-JS na Web<br />
<br />
==== Tecnologia de Back-end ====<br />
Arquitetura padrão para servidores Java e clientes Android<br />
Utilização de Java 7 e Android 4.4 ou superior<br />
<br />
==== Deploy ====<br />
Distribuição dos clientes android via Google Play<br />
Instalação dos servidores via instalador<br />
Pacotes de instalação APK versionados e assinados conforme padronização<br />
<br />
=Fundamentações das decisões tomadas=<br />
Nesta seção, coloque todas as considerações das tomadas de decisão realizadas para o produto. Porque foi usada tal arquitetura? Porque essa separação de componentes? Porque houve refatoração? Descreva o máximo possível nesta seção para que o histórico das decisões seja armazenado para consultas futuras.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Arquitetura_Classpad&diff=279Arquitetura Classpad2016-05-27T14:16:22Z<p>Edson.rodrigues: </p>
<hr />
<div>=Informações Gerais=<br />
<br />
== Ambientes utilizados ==<br />
{| class="wikitable"<br />
|-<br />
! Ambiente<br />
! URL de Acesso<br />
! Credenciais Admin<br />
|-<br />
| Desenvolvimento<br />
| http://dev-mscro.mstech.com.br<br />
| admin / 123456<br />
|-<br />
| Testes<br />
| http://tst-mscro.mstech.com.br<br />
| admin / ms@cro<br />
|-<br />
| Testes<br />
| http://tst-mscro.mstech.com.br<br />
| admin / ms@cro<br />
|-<br />
| Homologação Externa<br />
| http://hom-mscro.mstech.com.br<br />
| Informação exclusiva do Devops/GTI<br />
|-<br />
| Produção<br />
| http://mscro.mstech.com.br<br />
| Informação exclusiva do Devops/GTI<br />
|}<br />
<br />
== Repositório de Versionamento ==<br />
'''Ambiente:''' GITLab - Git<br />
<br />
'''Nome:''' MSCRO<br />
<br />
'''Caminho:''' https://gitlab.mstech.com.br/mscro/app-mscro.git<br />
<br />
'''Estrutura dos branches:''' Código mantido no tronco, porém mantemos 2 branches para os clientes SP e RJ.<br />
<br />
=Visão de Componentes=<br />
<br />
[[File:Classpad-escola.png]]<br />
<br />
[[File:/home/edson.rodrigues/Pictures/18d3tlxw9wtwzjpg.jpg]]<br />
<br />
=Decisões de Arquitetura=<br />
<br />
==== Persistência ====<br />
Através de banco de dados relacional<br />
Criação do banco de dados PostgreSQL nos servidores e em Realm nos dispositivos<br />
<br />
==== Tecnologia de integração ====<br />
Será realizada por meio de troca de mensagens entre os dispositivos e o servidor Datacenter e/ou servidor na escola<br />
Tráfego via WSS entre servidores e dispositivos<br />
Tráfego via HTTPS entre servidores e entre servidores e dispositivos<br />
<br />
==== Log ====<br />
Implementado log de negócio (para rastreabilidade das ações do usuário) e de log técnico para análise de funcionamento e falhas<br />
Para os logs utilizamos arquivos de texto gerenciado pelo LOG4J2<br />
Para crash report usaremos Crashlytics (Fabric.io) <br />
<br />
==== Padrão de arquitetura utilizado ====<br />
Utilizamos Servidores HTTPS RESTful na arquitetura JAX-RS para gerenciamento de APIs.<br />
Utilizamos o padrão de arquitetura DDD (Domain Driven Design) na aplicação web para ambiente de administração do servidor.<br />
Utilizamos o padrão “thin client” para os dispositivos. <br />
Utilizamos o padrão PubSub na comunicação durante uma sessão de aprendizagem<br />
Utilizamos o protocolo MDNS (Bonjour) para descoberta do servidor da escola<br />
Utilização de Jetty 9 para servidor HTTPS e WSS.<br />
Utilização de Hibernate 4 para comunicação com banco de dados PostgreSQL e SQLite.<br />
Utilização de JMDNS para Discovery na rede.<br />
<br />
==== Tecnologia de Front-end ====<br />
Utilização do design nativo Android<br />
Utilização de front end simplificado nos ambientes de Administração<br />
Aplicação de Material Design no Android e Angular-JS na Web<br />
<br />
==== Tecnologia de Back-end ====<br />
Arquitetura padrão para servidores Java e clientes Android<br />
Utilização de Java 7 e Android 4.4 ou superior<br />
<br />
==== Deploy ====<br />
Distribuição dos clientes android via Google Play<br />
Instalação dos servidores via instalador<br />
Pacotes de instalação APK versionados e assinados conforme padronização<br />
<br />
=Fundamentações das decisões tomadas=<br />
Nesta seção, coloque todas as considerações das tomadas de decisão realizadas para o produto. Porque foi usada tal arquitetura? Porque essa separação de componentes? Porque houve refatoração? Descreva o máximo possível nesta seção para que o histórico das decisões seja armazenado para consultas futuras.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Arquitetura_Classpad&diff=276Arquitetura Classpad2016-05-27T13:34:17Z<p>Edson.rodrigues: /* Visão de Componentes */</p>
<hr />
<div>=Informações Gerais=<br />
<br />
== Ambientes utilizados ==<br />
{| class="wikitable"<br />
|-<br />
! Ambiente<br />
! URL de Acesso<br />
! Credenciais Admin<br />
|-<br />
| Desenvolvimento<br />
| http://dev-mscro.mstech.com.br<br />
| admin / 123456<br />
|-<br />
| Testes<br />
| http://tst-mscro.mstech.com.br<br />
| admin / ms@cro<br />
|-<br />
| Testes<br />
| http://tst-mscro.mstech.com.br<br />
| admin / ms@cro<br />
|-<br />
| Homologação Externa<br />
| http://hom-mscro.mstech.com.br<br />
| Informação exclusiva do Devops/GTI<br />
|-<br />
| Produção<br />
| http://mscro.mstech.com.br<br />
| Informação exclusiva do Devops/GTI<br />
|}<br />
<br />
== Repositório de Versionamento ==<br />
'''Ambiente:''' GITLab - Git<br />
<br />
'''Nome:''' MSCRO<br />
<br />
'''Caminho:''' https://gitlab.mstech.com.br/mscro/app-mscro.git<br />
<br />
'''Estrutura dos branches:''' Código mantido no tronco, porém mantemos 2 branches para os clientes SP e RJ.<br />
<br />
=Visão de Componentes=<br />
<br />
[[File:Classpad-servidor.png]]<br />
<br />
=Decisões de Arquitetura=<br />
<br />
==== Persistência ====<br />
Através de banco de dados relacional<br />
Criação do banco de dados PostgreSQL nos servidores e em Realm nos dispositivos<br />
<br />
==== Tecnologia de integração ====<br />
Será realizada por meio de troca de mensagens entre os dispositivos e o servidor Datacenter e/ou servidor na escola<br />
Tráfego via WSS entre servidores e dispositivos<br />
Tráfego via HTTPS entre servidores e entre servidores e dispositivos<br />
<br />
==== Log ====<br />
Implementado log de negócio (para rastreabilidade das ações do usuário) e de log técnico para análise de funcionamento e falhas<br />
Para os logs utilizamos arquivos de texto gerenciado pelo LOG4J2<br />
Para crash report usaremos Crashlytics (Fabric.io) <br />
<br />
==== Padrão de arquitetura utilizado ====<br />
Utilizamos Servidores HTTPS RESTful na arquitetura JAX-RS para gerenciamento de APIs.<br />
Utilizamos o padrão de arquitetura DDD (Domain Driven Design) na aplicação web para ambiente de administração do servidor.<br />
Utilizamos o padrão “thin client” para os dispositivos. <br />
Utilizamos o padrão PubSub na comunicação durante uma sessão de aprendizagem<br />
Utilizamos o protocolo MDNS (Bonjour) para descoberta do servidor da escola<br />
Utilização de Jetty 9 para servidor HTTPS e WSS.<br />
Utilização de Hibernate 4 para comunicação com banco de dados PostgreSQL e SQLite.<br />
Utilização de JMDNS para Discovery na rede.<br />
<br />
==== Tecnologia de Front-end ====<br />
Utilização do design nativo Android<br />
Utilização de front end simplificado nos ambientes de Administração<br />
Aplicação de Material Design no Android e Angular-JS na Web<br />
<br />
==== Tecnologia de Back-end ====<br />
Arquitetura padrão para servidores Java e clientes Android<br />
Utilização de Java 7 e Android 4.4 ou superior<br />
<br />
==== Deploy ====<br />
Distribuição dos clientes android via Google Play<br />
Instalação dos servidores via instalador<br />
Pacotes de instalação APK versionados e assinados conforme padronização<br />
<br />
=Fundamentações das decisões tomadas=<br />
Nesta seção, coloque todas as considerações das tomadas de decisão realizadas para o produto. Porque foi usada tal arquitetura? Porque essa separação de componentes? Porque houve refatoração? Descreva o máximo possível nesta seção para que o histórico das decisões seja armazenado para consultas futuras.</div>Edson.rodrigueshttp://wiki.mstech.com.br/index.php?title=Arquitetura_Classpad&diff=275Arquitetura Classpad2016-05-27T13:22:59Z<p>Edson.rodrigues: /* Visão de Componentes */</p>
<hr />
<div>=Informações Gerais=<br />
<br />
== Ambientes utilizados ==<br />
{| class="wikitable"<br />
|-<br />
! Ambiente<br />
! URL de Acesso<br />
! Credenciais Admin<br />
|-<br />
| Desenvolvimento<br />
| http://dev-mscro.mstech.com.br<br />
| admin / 123456<br />
|-<br />
| Testes<br />
| http://tst-mscro.mstech.com.br<br />
| admin / ms@cro<br />
|-<br />
| Testes<br />
| http://tst-mscro.mstech.com.br<br />
| admin / ms@cro<br />
|-<br />
| Homologação Externa<br />
| http://hom-mscro.mstech.com.br<br />
| Informação exclusiva do Devops/GTI<br />
|-<br />
| Produção<br />
| http://mscro.mstech.com.br<br />
| Informação exclusiva do Devops/GTI<br />
|}<br />
<br />
== Repositório de Versionamento ==<br />
'''Ambiente:''' GITLab - Git<br />
<br />
'''Nome:''' MSCRO<br />
<br />
'''Caminho:''' https://gitlab.mstech.com.br/mscro/app-mscro.git<br />
<br />
'''Estrutura dos branches:''' Código mantido no tronco, porém mantemos 2 branches para os clientes SP e RJ.<br />
<br />
=Visão de Componentes=<br />
<br />
[[File:Classpad-servidor.png]]<br />
<br />
<br />
<br />
[[/home/edson.rodrigues/Pictures/18d3tlxw9wtwzjpg.jpg]]<br />
<br />
=Decisões de Arquitetura=<br />
<br />
==== Persistência ====<br />
Através de banco de dados relacional<br />
Criação do banco de dados PostgreSQL nos servidores e em Realm nos dispositivos<br />
<br />
==== Tecnologia de integração ====<br />
Será realizada por meio de troca de mensagens entre os dispositivos e o servidor Datacenter e/ou servidor na escola<br />
Tráfego via WSS entre servidores e dispositivos<br />
Tráfego via HTTPS entre servidores e entre servidores e dispositivos<br />
<br />
==== Log ====<br />
Implementado log de negócio (para rastreabilidade das ações do usuário) e de log técnico para análise de funcionamento e falhas<br />
Para os logs utilizamos arquivos de texto gerenciado pelo LOG4J2<br />
Para crash report usaremos Crashlytics (Fabric.io) <br />
<br />
==== Padrão de arquitetura utilizado ====<br />
Utilizamos Servidores HTTPS RESTful na arquitetura JAX-RS para gerenciamento de APIs.<br />
Utilizamos o padrão de arquitetura DDD (Domain Driven Design) na aplicação web para ambiente de administração do servidor.<br />
Utilizamos o padrão “thin client” para os dispositivos. <br />
Utilizamos o padrão PubSub na comunicação durante uma sessão de aprendizagem<br />
Utilizamos o protocolo MDNS (Bonjour) para descoberta do servidor da escola<br />
Utilização de Jetty 9 para servidor HTTPS e WSS.<br />
Utilização de Hibernate 4 para comunicação com banco de dados PostgreSQL e SQLite.<br />
Utilização de JMDNS para Discovery na rede.<br />
<br />
==== Tecnologia de Front-end ====<br />
Utilização do design nativo Android<br />
Utilização de front end simplificado nos ambientes de Administração<br />
Aplicação de Material Design no Android e Angular-JS na Web<br />
<br />
==== Tecnologia de Back-end ====<br />
Arquitetura padrão para servidores Java e clientes Android<br />
Utilização de Java 7 e Android 4.4 ou superior<br />
<br />
==== Deploy ====<br />
Distribuição dos clientes android via Google Play<br />
Instalação dos servidores via instalador<br />
Pacotes de instalação APK versionados e assinados conforme padronização<br />
<br />
=Fundamentações das decisões tomadas=<br />
Nesta seção, coloque todas as considerações das tomadas de decisão realizadas para o produto. Porque foi usada tal arquitetura? Porque essa separação de componentes? Porque houve refatoração? Descreva o máximo possível nesta seção para que o histórico das decisões seja armazenado para consultas futuras.</div>Edson.rodrigues