Backup / restauração pela interface do usuário

Crie um bucket do S3 na AWS na sua conta para o qual você deseja exportar os backups.

A AWS usa autenticação baseada em roles, então crie uma IAM role que o serviço ClickHouse Cloud poderá assumir para gravar nesse bucket.

• a. Obtenha o ARN na página de configurações do serviço ClickHouse Cloud, em Network security information, que será semelhante a este:

• b. Para essa role, crie a política de confiança da seguinte forma:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "backup service",
      "Effect": "Allow",
      "Principal": {
        "AWS":  "arn:aws:iam::463754717262:role/CH-S3-bordeaux-ar-90-ue2-29-Role"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Você também precisará definir as permissões dessa role para que este serviço ClickHouse Cloud possa gravar no bucket do S3. Isso é feito criando uma política de permissões para a role com um JSON semelhante a este, no qual você substitui o ARN do seu bucket no recurso em ambos os locais.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "s3:GetBucketLocation",
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::byob-ui"
      ],
      "Effect": "Allow"
    },
    {
      "Action": [
        "s3:Get*",
        "s3:List*",
        "s3:PutObject"
      ],
      "Resource": [
        "arn:aws:s3:::byob-ui/*"
      ],
      "Effect": "Allow"
    },
    {
      "Action": [
        "s3:DeleteObject"
      ],
      "Resource": [
        "arn:aws:s3:::byob-ui/*/.lock"
      ],
      "Effect": "Allow"
    }
  ]
}

Na página Settings, clique em Configurar backup externo:

Na tela seguinte, informe o ARN da IAM role da AWS que você acabou de criar e a URL do bucket do S3 no formato a seguir:

Clique em “Salvar bucket externo” para salvar as configurações

Agora, os backups externos serão realizados no seu bucket de acordo com o agendamento padrão. Como alternativa, você pode configurar o agendamento de backups na página “Settings”. Se ele for configurado de outra forma, o agendamento personalizado será usado para gravar backups no seu bucket, e o agendamento padrão (backups a cada 24 horas) será usado para os backups no bucket pertencente ao ClickHouse Cloud.

A página Backups exibirá esses backups no seu bucket em uma tabela separada, como mostrado abaixo:

Crie um novo serviço para o qual o backup será restaurado.

Adicione o ARN do serviço recém-criado (na página de configurações do serviço no console do ClickHouse Cloud) à política de confiança da IAM role. Isso é o mesmo que a segunda etapa na seção Etapas da AWS acima. Isso é necessário para que o novo serviço possa acessar o bucket do S3.

Clique no link “acessar ou restaurar um backup” acima da lista de backups na UI para obter o comando SQL de restauração do backup. O comando será semelhante a este:

Execute o comando de restauração no console SQL do serviço recém-criado para restaurar o backup.

Crie um bucket de armazenamento na sua conta do GCP para exportar backups.

Gere uma chave HMAC e um segredo, necessários para a autenticação baseada em senha. Siga as etapas abaixo para gerar as chaves:

• a. Crie uma conta de serviço

  • I. Acesse a seção IAM & Admin no Google Cloud Console e selecione Service Accounts.
  • II. Clique em Create Service Account e forneça um nome e um ID. Clique em Create and Continue.
  • III. Conceda a função Storage Object User a essa conta de serviço.
  • IV. Clique em Done para concluir a criação da conta de serviço.

• b. Gere a chave HMAC

  • I. Vá para Cloud Storage no Google Cloud Console e selecione Settings
  • II Vá para a guia Interoperability.
  • III. Na seção Service account HMAC, clique em Create a key for a service account.
  • IV. Escolha a conta de serviço que você criou na etapa anterior no menu suspenso.
  • V. Clique em Create key.

• c. Armazene as credenciais com segurança:

  • I. O sistema exibirá o Access ID (sua chave HMAC) e o Secret (seu segredo HMAC). Salve esses valores, pois o segredo não será exibido novamente depois que você fechar esta janela.

Na página Settings, clique em Alterar backup externo

Na janela pop-up, informe o caminho do bucket do GCP, a chave HMAC e o Secret criados na seção anterior.

Clique em Save External Bucket para salvar as configurações.

Os backups externos passarão a ser realizados no seu bucket de acordo com o agendamento padrão. Como alternativa, você pode configurar o agendamento de backup na página Settings. Se ele for configurado de outra forma, o agendamento personalizado será usado para gravar backups no seu bucket, e o agendamento padrão (backups a cada 24 horas) será usado para backups no bucket do ClickHouse Cloud.

A página Backups deve exibir esses backups no seu bucket em uma tabela separada, como mostrado abaixo:

Crie um novo serviço para o qual o backup será restaurado.

Clique no link acessar ou restaurar um backup acima da lista de backups na UI para obter o comando SQL para restaurar o backup. O comando deve ser parecido com este, e você pode selecionar o backup adequado no menu suspenso para obter o comando de restauração desse backup específico. Você precisará adicionar sua chave de acesso secreta ao comando:

Execute o comando de restauração no console SQL do serviço recém-criado para restaurar o backup.

Crie uma conta de armazenamento ou selecione uma conta de armazenamento existente no portal do Azure onde deseja armazenar seus backups.

• a. Na visão geral da sua conta de armazenamento, procure a seção chamada Security + networking e clique em Access keys.
• b. Aqui, você verá key1 e key2. Em cada uma delas, encontrará um campo Connection string.
• c. Clique em Show para exibir a string de conexão. Copie a string de conexão que você usará na configuração do ClickHouse Cloud.

Na página Settings, clique em Alterar backup externo

Na próxima tela, informe a Connection String e o Container Name da sua conta de armazenamento do Azure criada na seção anterior:

Clique em Salvar bucket externo para salvar as configurações

Os backups externos passarão a ser feitos no seu bucket de acordo com o agendamento padrão. Como alternativa, você pode configurar o agendamento de backup na página Settings. Se ele for configurado de forma diferente, o agendamento personalizado será usado para gravar backups no seu bucket, e o agendamento padrão (backups a cada 24 horas) será usado para os backups no bucket gerenciado pelo ClickHouse Cloud.

A página Backups deve exibir esses backups no seu bucket em uma tabela separada, como mostrado abaixo:

Crie um novo serviço para o qual o backup será restaurado. No momento, oferecemos suporte apenas à restauração de um backup em um novo serviço.

Clique no link acessar ou restaurar um backup acima da lista de backups na UI para obter o comando SQL de restauração do backup. O comando deve ser parecido com este, e você pode selecionar o backup apropriado na lista suspensa para obter o comando de restauração desse backup específico. Você precisará adicionar ao comando a string de conexão da sua conta de armazenamento do Azure.

Execute o comando de restauração no console SQL do serviço recém-criado para restaurar o backup.