This repository has been archived by the owner on Oct 20, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 173
/
Copy pathHELP
214 lines (190 loc) · 15.1 KB
/
HELP
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
Autor: Robson Vaamonde
Site: www.procedimentosemti.com.br
Facebook: facebook.com/ProcedimentosEmTI
Facebook: facebook.com/BoraParaPratica
YouTube: youtube.com/BoraParaPratica
Linkedin: https://www.linkedin.com/in/robson-vaamonde-0b029028/
Instagram: https://www.instagram.com/procedimentoem/?hl=pt-br
Github: https://github.com/vaamonde
Data de criação: 19/10/2021
Data de atualização: 03/10/2022
Versão: 0.18
Testado e homologado para a versão do Ubuntu Server 20.04.x LTS x64
#======================= COMO UTILIZAR OS SCRIPTS DESSE CURSO NO SEU SERVIDOR =======================
Para você se manter atualizado de todas as novidades do repositório do Ubuntu Server 20.04.x no Github,
recomendo os 4 (quatro) procedimentos abaixo:
Antes de tudo, criar uma conta no Github: https://github.com/signup
Primeiro: Ajudar o projetado clicando no Ícone "STAR" (Estrela) do repositório ubuntu-2004/
Segundo.: Para receber as notificações clique no Ícone "WATCH" (Observar) do repositório ubuntu-2004/
Terceiro: Caso você conheça os conceitos de "FORK" (Garfar) faça um Fork do repositório ubuntu-2004/
Quarto..: Dúvidas, críticas ou sugestões mande na Guia "ISSUES" (Questões) do repositório ubuntu-2004/
#00_ Arquivos e diretórios principais do curso de Ubuntu Server 20.04.x LTS x64 DevOps Shell Script.
_ README: arquivo de documentação principal do curso, contendo os links para os vídeos e documentação.
_ BUGS: arquivo dos Bugs (Erros) encontrados nos scripts, arquivos de configuração ou na Guia Issues.
_ CHANGELOG: arquivo de criação, mudanças ou melhorias nos scripts ou arquivos configuração.
_ FAQ: arquivo de perguntas frequentes do curso, scripts, arquivos de configuração e serviços de rede.
_ HELP: arquivo de ajuda desse curso, com procedimentos e documentação de utilização dos scripts.
_ LICENSE: arquivo de licença de uso dos scripts: MIT License.
_ NEWS: arquivo de novidades dos scripts, arquivos de configuração, serviços de rede, etc...
_ RELEASE: arquivo das versões homologadas de cada script após os testes finais e análise dos Logs.
_ ROADMAP: arquivo com a sequência das gravações das vídeo aulas desse curso (Guia Projects).
_ PORTS: arquivo de portas e protocolos TCP ou UDP utilizados pelos serviços de rede desse curso.
_ WARNING: arquivo de informações importantes sobre os scripts e arquivos de configuração.
_ scripts/: diretório dos scripts desse curso, numerados por sequência de uso e prioridade.
_ scripts/conf/: diretório dos arquivos de configuração (conf) dos serviços de rede desse curso.
_ scripts/install: diretório dos arquivos de instalação e configuração do Ubuntu Server.
_ scripts/settings/: diretório dos arquivos de configuração principal do Ubuntu Server.
#01_ Instalação do Ubuntu Server 20.04.x LTS x64.
_ Todos os procedimentos de criação da máquina virtual e instalação do Ubuntu Server 20.04.x LTS
_ se encontra no diretório: ubuntu-2004/scripts/install.
_ Os principais arquivos de instalação do Ubuntu Server são:
_ 01-InstalacaoDoUbuntuServer-20.04.3-LTS.md (utilizado nesse curso);
_ 02-InstalacaoDoUbuntuServer-20.04-RPI.md;
_ 03-InstalacaoDoUbuntuCore-20-RPI.md.
#02_ Configurações básicas do Ubuntu Server 20.04.x LTS x64.
_ Todos os procedimentos de configuração básica do Ubuntu Server 20.04.x LTS se encontra no
_ diretório: ubuntu-2004/scripts/settings/.
_ Os principais arquivos de configuração do Ubuntu Server são:
_ 01-AtualizacaoDoSistema.sh;
_ 02-ConfiguracaoDoHostnameHosts.sh;
_ 03-ConfiguracaoDoLocaleTimezoneKeyboard.sh;
_ 04-ConfiguracaoDoNetplan.sh;
_ 05-DesligarReiniciar.sh.
_ OBSERVAÇÃO IMPORTANTE: É recomendado fazer a configuração básica do Ubuntu Server antes de
_ executar os scripts desse curso.
#03_ Diretório dos scripts utilizados no Ubuntu Server 20.04.x LTS x64.
_ Todos os scripts de instalação e configuração dos serviços de rede no Ubuntu Server 20.04.x
_ LTS se encontra no diretório: ubuntu-2004/scripts/.
_ Todos os arquivos de configuração dos serviços de rede no Ubuntu Server 20.04.x LTS se
_ encontra no diretório: /ubuntu-2004/scripts/conf/.
_ Cada serviço de rede possui o seu subdiretório com o nome do seu serviço, exemplo: zabbix/,
_ zimbra/, samba/, etc...
_ Caso você queira adaptar os scripts ou arquivos de configuração para o seu cenário/servidor,
_ primeira etapa é editar o script correspondente, verificar as principais variáveis e arquivos
_ de configuração, alterar seus valores primeiro antes de executar os script.
#04_ Arquivo de configuração dos Parâmetros (Variáveis) dos scripts.
_ Arquivo de parâmetros (Variáveis) localizado em: /ubuntu-2004/scripts/00-parametros.sh
_ Esse arquivo é constituído de VARIÁVEL="VALOR", cada script tem um Bloco de Configuração
_ de Variáveis, algumas variáveis são reutilizadas em vários scripts ou adicionada na variável
_ do bloco de configuração do serviço: VARIÁVEL=$VARIÁVEL.
_ Antes de iniciar as configurações dos serviços de rede no Ubuntu Server, é recomendado
_ customizar o arquivo de parâmetros: 00-parametros.sh e os arquivos de configurações (conf)
_ no diretório: /ubuntu-2004/scripts/conf/ de cada serviço de rede corresponde a seu script e
_ na sequência customizar o script correspondente ao serviço de rede que está sendo executado.
#05_ Scripts de instalação e configuração dos serviços de rede.
_ Todos os script de instalação e configuração dos serviços de rede no Ubuntu Server segue o
_ mesmo padrão, todos os scripts estão interligados no arquivo: 00-parametros.sh na linha de
_ configuração: "SOURCE", todos os scripts geram arquivos de "LOG" no diretório: /var/log/ com o
_ nome do arquivo do script configurado na linha: "LOG", todos os script tem um Bloco de Teste
_ Lógico "(If)" básico que verifica se o usuário é "Root" e se a Distribuição é "20.04", alguns
_ scripts tem o Bloco de Laço de Loop para verificar se as principais dependências estão
_ instaladas, todos os scripts foram desenvolvidos para serem executados apenas "1 (uma)" vez.
#06_ Clonando o projeto do Github e executando os scripts.
_ Para utilizar os scripts desse curso, é recomendado você se logar com o usuário Root do Ubuntu.
_ Primeiro: se logar com o seu usuário que tem direitos administrativos no terminal do Ubuntu;
_ Segundo: se logar como Root utilizando o comando: sudo -i <Enter> digitar a sua senha;
_ Terceiro: clonar o projeto: git clone https://github.com/vaamonde/ubuntu-2004 --depth=1 <Enter>;
_ OBS1: a opção do comando git: --depth=1 cria um clone superficial com um histórico truncado para
_ o número especificado de confirmações (somente o último commit geral do repositório).
_ Quarto: acessar o diretório clonado do Github: cd ubuntu-2004/ <Enter>;
_ Quinto: acessar o diretório dos scripts: cd scripts/ <Enter>;
_ Sexto: rodar um script de serviço: bash 00-nome_do_script.sh <Enter>.
_ OBSERVAÇÃO IMPORTANTE: não é necessário transformar os scripts em executáveis utilizando o comando:
_ chmod +x *.sh, pois o comando Bash já executa os scripts por causa da primeira linha configurada
_ em todos os scripts: #!/bin/bash
#07_ Monitorando o Log em tempo real dos script.
_ Todos os scripts redireciona a saída padrão dos comandos utilizados para a variável: LOG que gera
_ um arquivo no diretório: /var/log/ com o nome do script que está sendo executado, exemplo: bash
_ 01-openssh.sh - arquivo de Log: /var/log/01-openssh.sh.
_ Para visualizar em tempo real o Log da instalação e configuração do serviço de rede, você vai abrir
_ um novo Terminal (Alt+F2), se logar com seu usuário que tem direitos administrativos e executar o
_ comando: sudo tail -f /var/log/01-openssh.sh, para sair do monitoramento do Log e só pressionar:
_ Ctrl+C.
_ Para analisar o Log após a instalação utilize o comando: sudo less /var/log/01-openssh.sh, para
_ sair do arquivo de Log e só pressionar: q (quit).
_ Todos os scripts, arquivos de configuração e serviços de rede gera Logs no servidor Ubuntu Server
_ os procedimentos para analisar e debugar os Logs estão no script: 00-parametros.sh
#08_ Atualizando os scripts para o seu cenário.
_ É recomendado você fazer um "FORK" do projeto para manter o seu repositório atualizado com as suas
_ modificações, sempre verifique as mudanças no repositório principal em relação a "BUGS" ou melhorias
_ nos scripts e arquivos de configuração analisando sempre a Versão do arquivo nas linhas: Data de
_ atualização e Versão juntamente com os arquivos "CHANGELOG", "BUGS" e "RELEASE".
#09_ Executando os scripts mais de uma vez no mesmo cenário.
_ Os scripts foram projetados para serem executados apenas uma vez no cenário que está sendo aplicado,
_ antes de executar os scripts é recomendado fazer um "Snapshot" do servidor e depois rodar o script
_ do serviço corresponde, caso queira executar novamente o script será necessário remover ou renomear
_ o arquivo de LOG do script em: /var/log, por exemplo, arquivo de log do SSH: /var/log/01-openssh.sh
_ renomear para: sudo vm -v /var/log/01-openssh.sh /var/log/01-openssh.sh.old.
_ Listando todos os arquivos de Log executados no servidor: ls -lha /var/log/*.sh
#========================= HABILITANDO OU DESABILITANDO RECURSOS NOS SCRIPTS ==========================
#01_ Desabilitando a checagem das dependências dos scripts no arquivo 00-parametros.sh.
_ Para desabilitar a checagem das dependências dos scripts no arquivo: 00-parametros.sh você pode
_ fazer isso de duas formas:
_ Primeiro: removendo o nome do aplicativo da variável de Laço de Loop APLICATIVODEP=""
_ Segundo.: comentando a variável de Laço de Loop APLICATIVODEP=""
_ Para adicionar nos aplicativos para serem verificados no Laço de Loop é só adicionar o nome do
_ aplicativo na variável APLICATIVODEP="" separado por espaço.
#02_ Adicionando novas dependências na instalação dos scripts no arquivo 00-parametros.sh.
_ Para adicionar novas dependências na instalação do serviço de rede é só adicionar o nome do
_ aplicativo/dependência na variável APLICATIVOINSTALL="" ou na variável APLICATIVODEPINSTALL=""
_ separado por espaço.
_ Para remover uma dependências é só retirar das variáveis APLICATIVOINSTALL="" ou da variável
_ APLICATIVODEPINSTALL=""
#03_ Desabilitando recursos nos scripts, parâmetros ou arquivos de configuração.
_ Para desabilitar os recursos nos scripts é recomendado comentar as linhas utilizando o # (
_ (Hashtag/Sustenido) no início da linha que você quer desabilitar a função no script ou
_ arquivo de configuração.
_ OBSERVAÇÃO IMPORTANTE: alguns arquivos de configuração utiliza o ; (ponto e vírgula) como
_ caractere de comentário ou / (barra invertida), como por exemplo nos arquivos de configuração
_ do Bind DNS Server, PHP, Java, etc.
#========================== COMO AJUDAR NA MELHORIA OU CORREÇÕES DO SCRIPTS ==========================
#00_ Ajudando no "DEBUG" dos scripts.
_ Para ajudar no DEBUG dos scripts é recomendado você criar o mesmo cenário das vídeo aulas e das
_ configurações dos scripts e arquivos de configuração, mantendo o mesmo padrão e testando se está
_ tudo funcionando corretamente, caso encontre alguma falha nos scripts ou arquivos de configuração
_ enviar as correções na Guia ISSUES: https://github.com/vaamonde/ubuntu-2004/issues
_ OBS2: antes de enviar o BUG veja o arquivo: https://github.com/vaamonde/ubuntu-2004/blob/main/BUGS
_ se essa falha já consta lá, e se essa falha já foi resolvida.
_ OBS3: veja sempre o arquivo: https://github.com/vaamonde/ubuntu-2004/blob/main/CHANGELOG sobre as
_ correções e melhorias dos scripts e arquivos de configuração.
_ Veja também os COMMITS feito nos scripts ou arquivos de configuração diretamente no Github no Link
_ https://github.com/vaamonde/ubuntu-2004/commits/main
_ OBSERVAÇÃO IMPORTANTE: antes de enviar as correções na Guia ISSUES recomendo sempre Debugar os
_ arquivos de LOG primeiro, pesquisar a falha, documentar e enviar detalhes para ajudar no processo
_ de correção.
#01_ Ajudando na "MELHORIA" dos scripts.
_ Para ajudar na MELHORIA dos scripts é recomendado você criar um novo cenário, adaptar os scripts
_ para esse cenário e testar se tudo vai funcionar perfeitamente, depois documentar suas melhorias
_ e mandar as suas sugestões na Guia ISSUES: https://github.com/vaamonde/ubuntu-2004/issues.
_ OBSERVAÇÃO IMPORTANTE: antes de enviar as sugestões na Guia ISSUES recomendo sempre Debugar os
_ arquivos de LOG primeiro, pesquisar a falha, documentar e enviar detalhes para ajudar no processo
_ de correção.
#02_ Ajudando na "MELHORIA" dos arquivos de configuração.
_ Para ajudar na MELHORIA dos arquivos de configuração, esse procedimento é o mais importante, pois
_ afeta vários serviços de rede, as melhorias muitas vezes ajuda no cenário ou prejudica dependendo
_ da integração ou da finalidade do serviço que está sendo implementado, para isso é recomendado
_ criar um novo cenário, testar as melhorias nos arquivos de configuração e mandar as sugestões na
_ Guia ISSUES: https://github.com/vaamonde/ubuntu-2004/issues.
_ OBSERVAÇÃO IMPORTANTE: antes de enviar as melhorias na Guia ISSUES recomendo sempre Debugar os
_ arquivos de LOG primeiro, pesquisar a falha, documentar e enviar detalhes para ajudar no processo
_ de correção.
#03_ Ajudando na "SEGURANÇA" dos scripts ou arquivos de configuração
_ Para ajudar na SEGURANÇA dos scripts e arquivos de configuração é recomendado criar o mesmo cenário
_ ou um novo cenário e testar as falhas de segurança, principalmente dos serviços de rede, documentar
_ as falhas de segurança, sua correção e os procedimentos que precisa ser feito para resolver a falha
_ na Guia ISSUES: https://github.com/vaamonde/ubuntu-2004/issues.
_ OBSERVAÇÃO IMPORTANTE: antes de enviar as correções na Guia ISSUES recomendo sempre Debugar os
_ arquivos de LOG primeiro, pesquisar a falha, documentar e enviar detalhes para ajudar no processo
_ de correção.
#04_ Ajudando no "DESEMPENHO" dos arquivos de configuração
_ Para ajudar no DESEMPENHO dos arquivos de configuração é recomendado criar o mesmo cenário ou um
_ novo cenário e testar as opções de "Tuning" Otimização/Performance principalmente dos serviços de
_ rede como o MySQL, MariaDB, Apache2, Nginx, etc..., documentar as melhorias ou correções e enviar
_ na Guia ISSUES: https://github.com/vaamonde/ubuntu-2004/issues.
_ OBSERVAÇÃO IMPORTANTE: nesse cenário existe diferenças de desempenho em relação ao tipo de servidor
_ utilizado nos Testes de Desempenho (On-Premises, Virtual Machine, VPS, Cloud, Containner, etc...).
#05_ Enviando suas melhorias ou correções via "PULL REQUESTS"
_ Por padrão as melhorias ou correções enviadas via PULL REQUESTS do Github não serão submetidas nos
_ scripts ou arquivos de configuração, pois o projeto não foi criado para trabalhar com colaboração
_ no Github, por esse motivo os Pull Requests serão respondidos, mais aplicado suas melhorias ou
_ correções que estão documentadas na Guia ISSUES: https://github.com/vaamonde/ubuntu-2004/issues.