Skip to main content

Desenvolvimento profissional de scripts Selenium

Para implementar automação web eficiente na Square Cloud, é fundamental estabelecer um ambiente de desenvolvimento adequado e seguir as melhores práticas de configuração.

Pré-requisitos

  • Python e pip: Certifique-se de ter Python e pip instalados em seu sistema. Caso não os possua, faça o download no site oficial do Python e no site oficial do Pip.
  • Conta na Square Cloud: Crie sua conta através da página de cadastro, utilizando seu endereço de email para registro.
  • Plano ativo: É necessário possuir um plano ativo para garantir recursos adequados para execução de aplicações Selenium. Consulte nossos planos disponíveis e escolha o mais adequado às suas necessidades.

Configuração do ambiente Selenium

Com Python e pip instalados, proceda com a criação do script Selenium. Primeiro, instale a biblioteca Selenium:
Terminal
Em seguida, crie um arquivo Python (por exemplo, main.py) e adicione o código a seguir para implementar um script Selenium básico:
main.py

Gerenciamento de dependências com requirements.txt

O arquivo requirements.txt é um componente essencial que lista todas as bibliotecas externas necessárias para seu projeto. É fundamental incluir todas as dependências utilizadas, excluindo bibliotecas nativas do Python como random e datetime. Este arquivo deve ser incluído ao submeter sua aplicação à Square Cloud.
requirements.txt

Configuração do caminho do Chromium

Na implementação apresentada acima, não é necessário definir explicitamente o caminho do Chromium, pois o Selenium WebDriver pode localizar automaticamente o navegador quando instalado em uma localização padrão do sistema. O ChromeDriver, especificado com Service('/usr/bin/chromedriver'), possui conhecimento sobre onde localizar o executável do Chromium/Chrome.

Arquitetura da Square Cloud

Na Square Cloud, o Chromium está instalado em /usr/bin/chromium, que é a localização padrão do sistema. Portanto, o Selenium WebDriver pode localizá-lo automaticamente através do ChromeDriver especificado. Desta forma, não há necessidade de especificar explicitamente o caminho do Chromium no código, a menos que existam razões específicas para fazê-lo, como instalações personalizadas ou configurações de ambiente diferenciadas.

Configuração do arquivo Square Cloud

Crie um arquivo squarecloud.app na raiz do projeto, ao lado do main.py. Ele diz à Square Cloud como rodar o seu script:
squarecloud.app
  • MEMORY é a RAM em MB. O Chromium consome bastante memória, então dê a ele pelo menos 1024 MB e aumente se a aplicação parar com LACK_OF_RAM.
  • AUTORESTART=true inicia o script de novo se ele travar. Veja como funciona o auto restart.
  • Não há SUBDOMAIN: o script não serve páginas web.
O seu ZIP contém o main.py, o requirements.txt e o squarecloud.app.

Aprenda sobre: como criar o arquivo de configuração para a Square Cloud.

O arquivo squarecloud.app é um arquivo de configuração essencial que será utilizado para configurar sua aplicação na Square Cloud. Ele define nome, descrição, versão, arquivo principal, entre outras configurações fundamentais.

Upload do projeto para a Square Cloud

Após preparar todos os arquivos do projeto, proceda com o upload para a Square Cloud e hospede sua aplicação profissionalmente.

Via dashboard

1

Acesse a página de upload

Acesse a página de upload e envie seu arquivo zip.
2

Configure seu ambiente

Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.
3

Faça o deploy do projeto

Por fim, clique no botão “Deploy” para hospedar seu projeto na Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no dashboard.
Enviando aplicação para a Square Cloud
4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. No dashboard, aguarde o status da sua aplicação mudar para em execução e verifique os registros em busca de erros de inicialização.
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.
Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

Via CLI

Para usar esse método, seu projeto precisa de um arquivo de configuração chamado squarecloud.app na raiz. Ele informa à Square Cloud como executar a sua aplicação.

Guia do arquivo de configuração

Saiba como criar o arquivo de configuração squarecloud.app que define o ambiente da sua aplicação.
1

Instale a CLI

Instale a CLI da Square Cloud. Se você já a tem, execute o mesmo comando para atualizá-la:
2

Faça login

Execute o comando abaixo. Ele abre o seu navegador: aprove o login lá e a CLI está pronta. Não há nenhuma chave de API para copiar. Para scripts e CI, veja autenticação da CLI.
3

Envie o seu projeto

Na pasta do seu projeto, execute o comando abaixo. A CLI compacta a pasta atual, deixando de fora o que o squarecloud.ignore lista, e faz o upload:
Para enviar um zip que você mesmo criou, passe-o com --file:
4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. Verifique o status e os registros da sua aplicação diretamente pelo terminal:
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.
Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

Recursos adicionais e documentação

Para obter informações mais detalhadas sobre Selenium e suas ferramentas avançadas, visite a documentação oficial do Selenium. Lá você encontrará guias técnicos detalhados, tutoriais especializados e documentação completa da API para maximizar o aproveitamento das funcionalidades do Selenium.

Próximos passos

A aplicação não inicia

Corrija LACK_OF_RAM, módulos faltando e outras falhas na inicialização.

Runtime Python

Como a Square Cloud roda aplicações Python.

Variáveis de ambiente

Mantenha logins e chaves de API usados pela sua automação fora do código.

Contate-nos

Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão: a qualidade do suporte é uma grande parte do motivo pelo qual desenvolvedores avaliam a Square Cloud com 4,9/5 em 402 avaliações no Google e Trustpilot.