A implantação é uma pequena ferramenta para implantação de artefatos segmentada para desenvolvedores de software.
Escrevi o implantador para me ajudar a implantar artefatos em uma rede de testes quando estou trabalhando nas coisas. Eu provavelmente poderia ter usado meu IDE para isso, mas isso não é divertido!
Etapas sem helper de implantação:
Etapas com helper de implantação:
O arquivo de configuração padrão deploy-helper.json precisa estar no seu diretório de trabalho.
Exemplo de configuração:
{
// Required
"destinations" : [
{
// Name of the destination
"name" : "service1" ,
// Normally you would set a real address or a ip here,
// but you could also use aliases from your ssh config (like I did here)
"address" : "test-network" ,
// The path for our destination (used for the ssh session)
"path" : "/home/user/services/service1/data/" ,
// SSH_COMMANDS (ssh first, then commands) or
// COMMANDS_SSH (commands first, then ssh)
"order" : "SSH_COMMANDS"
} ,
{
"name" : "service2" ,
"address" : "test-network" ,
"path" : "/home/user/services/service1/data/" ,
"order" : "SSH_COMMANDS"
}
] ,
// Required
"artifact" : {
// Directory that contains the artifact
"directory" : "./target" ,
// Name regex that matches the artifact
"name" : "my-software-[\d.A-Za-z-]+\.jar" ,
// Sorting operation for possible artifacts
// LAST_MODIFIED_ASC (oldest file first) or
// LAST_MODIFIED_DESC (newest file first)
"sort" : "LAST_MODIFIED_DESC"
} ,
// Optional
"commands" : [
// Can be either a string or an array of strings
"scp {ARTIFACT_PATH} {SSH_USER}@{DEST_ADDRESS}:{DEST_PATH}{ARTIFACT_NAME}"
] ,
// Optional
"ssh" : {
// If port is > 0, the ssh command will be USER@HOST:PORT
// If the port is <= 0, the ssh command will be USER@HOST
"port" : 0 ,
// How long to wait for the connection to establish
"sleep" : "2000" ,
// The ssh user
"user" : "user" ,
// Plaintext password auth requires 'sshpass'
// "password": "foobar",
"commands" : [
// Commands have to be a string
"rm my-software-*.jar"
]
}
}Este exemplo de configuração faz o seguinte:
rm para excluir artefato antigoscp para copiar um novo artefato para o servidor Você também deve adicionar deploy-helper.json ao seu arquivo .gitignore .
Nota: Só pode haver um artefato.
{DEST_ADDRESS} : endereço de destino
{DEST_NAME} : nome de destino
{DEST_PATH} : caminho de destino
{SSH_USER} : usuário ssh
{SSH_PORT} : porta ssh
{ARTIFACT_PATH} : Caminho de artefato
{ARTIFACT_NAME} : nome do artefato
| Longo | Curto | Descrição |
|---|---|---|
| -Config | -C | Substituir o local da configuração |
| --verbose | -v | Se ativado, a saída do processo será redirecionada para stdout e stderr |
| --destino | -d | Substituir os destinos (lista separada por vírgula) |
A instalação de implantação é tão fácil quanto fazer o download do frasco da versão mais recente (em teoria). No entanto, você provavelmente deve manter o frasco em algum tipo de localização central.
É assim que eu 'instalei' implantam-helper na minha máquina Linux com ZSH:
sudo mkdir /opt/deploy-helpersudo chown max:max /opt/deploy-helpermv ~/Downloads/deploy-helper-*.jar /opt/deploy-helperecho "alias deploy='java --enable-preview -jar /opt/deploy-helper/deploy-helper-VERSION.jar'" >> ~/.zshrc Em seguida, basta reabrir seu terminal (ou source ~/.zshrc ) e terminar!
Comando básico:
java --enable-preview -jar deploy-helper-VERSION.jar OPTIONS
Vinculando o comando a um pseudônimo:
alias deploy='java --enable-preview -jar /opt/deploy-helper/deploy-helper-VERSION.jar'
Executando o Helper de implantação com outra configuração:
deploy -c ~/my-deploy-config.json
Executando o helper de implantação com destinos especificados:
deploy -d service1,service4,service5
Pré -requisitos:
Passos:
git clone https://github.com/cerus/deploy-helper.gitcd deploy-helpermvn clean packageSiga as diretrizes de contribuição