Skip to content
Robson edited this page Dec 14, 2019 · 2 revisions

Funções

Amazon Web Services

Para utilizar as funções relacionadas a AWS, certifique-se que a classe AwsCredentials esteja configurada com uma credential do Jenkins válida, contendo como variáveis AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY

Auto Scaling

Renew Auto Scaling Group

Função renewAutoScalingGroup
Descrição Renova as instâncias de um auto scaling group
Parâmetros groupName, region
Retorno Vazio
Detalhes Esta função renova/substitui as instâncias presentes em um Auto Scaling Group. Inicialmente a função incrementa o tamanho do grupo em um instância, e após esta instância estar disponível, começa a terminar as demais, sempre aguardando uma nova instância ser criada no lugar. Está estratégia faz com sempre existam, pelo menos, o número de instâncias que haviam quando a função foi chamada. No final do processo o Auto Scaling Group é reconfigurado para seu tamanho original. Está função é ideial, para estratégias de deploy, onde a aplicação é configurada na máquina quando a mesma é criada.

Exemplo de uso:

renewAutoScalingGroup("as-oh-umov-vpc-jboss-bluegreen", "us-east-2")  

Start and Renew Auto Scaling Group

Função startAndRenewAutoScalingGroup
Description Renova as instâncias de um auto scaling group. Se o grupo não possuir nenhuma instância, altera o tamanho do grupo para 1
Parameters groupName, region
Return Vazio
Details Esta função é similar à renewAutoScalingGroup tendo como única diferença, a lógica de iniciar uma instância no grupo, caso este esteja vazio. O objetivo, é atender alguns cenários de deploy no ambiente Bluegreen, onde as vezes o grupo não possui nenhuma instância.

Exemplo de uso:

startAndRenewAutoScalingGroup("as-oh-umov-vpc-jboss-bluegreen", "us-east-2")  

Set Auto Scaling Group Size

Função setAutoScalingGroupSize
Descrição Altera o tamanho um auto scaling group para os parâmetros desejados
Parâmetros groupName, region, minSize, maxSize, desiredCapacity
Retorno Vazio
Detalhes Esta função irá atualizar as três propriedades do AutoScalingGroup (minSize, maxSize, desiredCapacity) independente do seu valor atual

Exemplo de uso:

setAutoScalingGroupSize("as-oh-umov-vpc-jboss-bluegreen", "us-east-2", 1, 3, 2)  

Set Auto Scaling Group Size And Wait

Função setAutoScalingGroupSizeAndWait
Descrição Altera o tamanho um auto scaling group para os parâmetros desejados e aguarda as instâncias ficarem healthy no Load Balancer / Target Group
Parâmetros groupName, region, minSize, maxSize, desiredCapacity
Retorno Vazio
Detalhes Esta função irá atualizar as três propriedades do AutoScalingGroup (minSize, maxSize, desiredCapacity) independente do seu valor atual

Exemplo de uso:

setAutoScalingGroupSizeAndWait("as-oh-umov-vpc-jboss-bluegreen", "us-east-2", 1, 3, 2)  

EC2

Start Instance

Função startInstance
Descrição Inicia uma instância existente
Parâmetros instanceId, region
Retorno Vazio
Detalhes Esta função inicia uma instância EC2 existente. Caso o id informado não exista, uma exceção é lançada.

Exemplo de uso:

startInstance("i-02fbb04f42d6ecb1d", "us-east-2")

Stop Instance

Função stopInstance
Descrição Para uma instância existente
Parâmetros instanceId, region
Retorno Vazio
Detalhes Esta função para uma instância EC2 existente. Caso o id informado não exista, uma exceção é lançada.

Exemplo de uso:

stopInstance("i-02fbb04f42d6ecb1d", "us-east-2")

Restart Instance

Função restartInstance
Descrição Reinicia uma instância existente
Parâmetros instanceId, region
Retorno Vazio
Detalhes Esta função reinicia uma instância EC2 existente. Caso o id informado não exista, uma exceção é lançada.

Exemplo de uso:

restartInstance("i-02fbb04f42d6ecb1d", "us-east-2")

Terminate Instance

Função terminateInstance
Descrição Termina uma instância existente
Parâmetros instanceId, region
Retorno Vazio
Detalhes Esta função termina uma instância EC2 existente. CUIDADO!! A instância será perdida de forma permamente. Caso o id informado não exista, uma exceção é lançada.

Exemplo de uso:

terminateInstance("i-02fbb04f42d6ecb1d", "us-east-2")