Redshift

5 min

Resumo

Cria, deleta e modifca instancias de clusters Redshift

Parametros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
allow_version_upgrade			Flag para determinar se o upgrade da versão é possivel
automated_snapshot_retention_period			Periodo quando o snapshot foi criado
availability_zone			Zona de disponibilidade no qual for lançar o cluster
aws_access_key	string		Chave de acesso AWS. Se não for definido, o valor da variável de ambiente AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY ou EC2_ACCESS_KEY será usado. Se o perfil for definido, este parâmetro será ignorado.
aws_secret_key	string		Chave secreta da AWS. Se não for definido, o valor da variável de ambiente AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY ou EC2_SECRET_KEY será usado. Se o perfil for definido, este parâmetro será ignorado.
cluster_parameter_group_name	string		Nome do parameter group do cluster
cluster_security_groups	string		Em qual security group se deve colocar o cluster
cluster_subnet_group_name	string		Em qual subnet se deve colocar o cluster
cluster_type	string	Escolhas: multi-node single-node	O tipo de cluster
cluster_version	string	Escolhas: 1.0	Quais versões os clusters devem ter
command	string	Escolhas: create facts delete modify	Especifica as ações a tomar
db_name	string		Nome da database
elastic_ip			Se o cluster tem um IP elastico ou não
encrypted			Se o cluster for enciptado ou não
final_cluster_snapshot_identifier			Identificador do snapshot final para ser criado antes do cluster ser deletado. Se esse parametro for fornecido, final_cluster_snapshot_identifier terá que ser false. Usado somente quando command=delete
identifier			Redshift cluster idenficador
new_cluster_identifier			Somente usado quando command=modify
node_type		Escolhas: ds1.xlarge ds1.8xlarge ds2.xlarge ds2.8xlarge dc1.large dc1.8xlarge dc2.large dc2.8xlarge dw1.xlarge dw1.8xlarge dw2.large dw2.8xlarge	O tipo de node do cluster. Precisa ser especificado quando command=create.
number_of_nodes			Número de nodes. Somente usado quando cluster_type=multi-node
password			Password do master database. Usado somente qyuando o command=create.
port			Em qual porta o cluster é listado
preferred_maintenance_window			Janela de manutenção
ec2_url	string		URL a ser usada para conectar-se ao EC2 ou à sua nuvem Eucalyptus (por padrão, o módulo usará endpoints do EC2). Ignorado para módulos onde a região é necessária. Deve ser especificado para todos os outros módulos se a região não for usada. Se não for definido, o valor da variável de ambiente EC2_URL, se houver, será usado.
profile	string		O uso do perfil substituirá aws_access_key , aws_secret_key e security_token e o suporte para passá-los ao mesmo tempo em que o profile foi descontinuado.
publicly_accessible	bool	Default: no	Se o cluster for acessível publicamente ou não
region	string		A região da AWS a ser usada. Se não for especificado, o valor da variável de ambiente AWS_REGION ou EC2_REGION, se houver, será usado. Ver http://docs.aws.amazon.com
security_token	string		Token de segurança do AWS STS. Se não for definido, o valor da variável de ambiente AWS_SECURITY_TOKEN ou EC2_SECURITY_TOKEN será usado. Se o perfil for definido, este parâmetro será ignorado.
skip_final_cluster_snapshot	bool	Default: no	Pule a snapshot final antes de deletar o cluster. Usado somente quando command=delete.
username			Username master do database. Usado somente quando command=create
validate_certs	boolean	Escolhas: true(default) false	Quando definido como "não", os certificados SSL não serão validados para comunicação com as APIs da AWS.
vpc_security_group_ids	string		Security group do VPC
wait	bool	Escolhas: true false(default)	Quando command=create, modifica ou restaura então espera pelo database estar no estado "available". Quando command=delete espera pelo database ser terminada
wait_timeout	interger	Default: 300	Quanto tempo esperar antes de terminar a execução, em segundos

Extende fragmentos da documentação do módulo aws e ec2.

Exemplos

tasks:
- name: Basic cluster provisioning example
  redshift:
      aws_access_key: ABVCDSIOWD123
      aws_secret_key: ASDKmasdpvo21\cew.wedq12
      region: "us-east-1"
      command: create
      db_name: database-1
      node_type: dc2.large
      identifier: new-cluster1
      username: a12345678
      password: 12345678A

- name: Cluster delete example
  redshift:
      aws_access_key: ABVCDSIOWD123
      aws_secret_key: ASDKmasdpvo21\cew.wedq12
      region: "us-east-1"
      command: delete
      db_name: database-1
      identifier: new-cluster1
      skip_final_cluster_snapshot: True
      wait: True
      wait_timeout: 500
      username: a12345678
      password: 12345678A

  register: result
- debug:
    msg: "{{ result }}"

Valores retornados

Chave	Tipo	Retornado quando	Descrição
cluster	complex	sucesso	dict contendo todas as informações dos clusters

Subcamos de cluster

Chave	Tipo	Retornado quando	Descrição
identifier	string	sucesso	nome do grupo subnet do Redshift
create_time	string	sucesso	Id do VPC onde está o subnet
status	string	sucesso	status do cluster
db_name	string	sucesso	nome da database
availability_zone	string	sucesso	Disponibilidade da zona da Amazon onde o cluster está localizado
maintenance_window	string	sucesso	Prazo de tempo quando a manutenção/upgradesão feitos
private_ip_address	string	sucesso	IP privado do node principal
public_ip_address	string	sucesso	IP publico do node principal
port	int	sucesso	Porta do cluster
url	string	sucesso	FQDN do cluster do node principal