| title | excerpt | updated |
|---|---|---|
Criar tarefas automatizadas (CRON) no seu alojamento Web |
Saiba como criar tarefas CRON para automatizar as tarefas programadas num alojamento web |
2025-02-20 |
No seu alojamento Web OVHcloud, pode utilizar scripts para automatizar certas operações. A criação de uma tarefa planificada ("tarefa CRON") é a forma mais simples de assegurar que os seus scripts são executados em momentos específicos sem que seja necessário mais ações da sua parte.
Saiba como criar tarefas CRON para automatizar as tarefas planeadas num alojamento web.
Warning
A responsabilidade sobre a configuração e a gestão dos serviços que a OVHcloud disponibiliza recai sobre o utilizador. Assim, deverá certificar-se de que estes funcionam corretamente.
Este manual fornece as instruções necessárias para realizar as operações mais habituais. No entanto, se tiver alguma dúvida, recomendamos que recorra a um fornecedor de serviços especializado e/ou que contacte o editor do serviço. Não poderemos proporcionar-lhe assistência técnica. Para mais informações, aceda à secção “Quer saber mais?” deste manual.
- Ter um serviço de alojamento Web da OVHcloud.
- Ter acesso à Área de Cliente OVHcloud.
Aceda à Área de Cliente OVHcloud. Clique no separador Web Cloud{.action} e, a seguir, em Alojamentos{.action}.
Selecione o alojamento em causa, clique no separador Mais{.action} e, a seguir, em Cron{.action}.
Nesta secção, terá uma visão geral das tarefas planeadas e dos respetivos parâmetros.
{.thumbnail}
Para criar uma tarefa CRON, clique no botão Adicionar um planeamento{.action} à direita. Pode personalizar os parâmetros da tarefa na nova janela.
{.thumbnail}
| Opção | Descrição |
|---|---|
| Comando a executar | Defina o caminho de acesso ao ficheiro que contém o script. Exemplo: www/jobs/cron.php |
| Linguagem | Selecione a versão PHP utilizada pelo script. |
| Ativação | Escolha se a tarefa será ativa após a sua criação ou ativada posteriormente. |
| Logs por e-mail | Se necessário, selecione um contacto (administrador ou técnico) ao qual será enviado um relatório em caso de erro de execução. Pode também fornecer outro endereço de e-mail. |
| Descrição | Introduza uma descrição para seguir a execução das suas tarefas. |
Clique em Seguinte{.action} para passar ao passo 2.
A interface oferece dois modos para configurar a frequência da sua tarefa. Utilize o Modo Simple para uma seleção de opções de planeamento simplificado para os principiantes. Se prefere entrar diretamente uma frequência, semelhante a um formato de tabela CRON (crontab), escolha o Modo expert.
| Modo simples |
|---|
| Utilize os menus pendente para especificar a hora, os dias de um mês, os dias da semana e os meses da tarefa. |
 {.thumbnail} |
[!primary]
O formulário
Dias{.action} permite definir frequências de execução num ciclo mensal.O formulário
Dias da semana{.action} permite definir frequências de execução complementares mas com um ciclo semanal.
| Modo expert |
|---|
| Introduza valores numéricos como num crontab. Os asteriscos indicam cada valor do período, o que significa que a tarefa será realizada continuamente uma vez por hora, todos os dias, no exemplo. |
 {.thumbnail} |
Pode alternar entre os dois modos durante a configuração para visualizar as alterações em conformidade. Tenha em atenção as limitações durante o planeamento de uma tarefa num alojamento Web.
{.thumbnail}
O resumo lembra-lhe os parâmetros configurados, incluindo a notação crontab da frequência de execução. Se tudo estiver correto, clique em Validar{.action}.
{.thumbnail}
A tarefa estará pronta dentro de alguns minutos. Pode alterar todos os seus parâmetros ou eliminar a tarefa clicando em ...{.action} na tabela de apresentação do seu painel de configuração OVHcloud.
Clique nas guias abaixo para exibir sucessivamente cada um dos 4 etapas.
[!tabs] Etapa 1
Aceda à Área de Cliente OVHcloud e aceda à secção
Web Cloud{.action}.
{.thumbnail}
Etapa 2
Clique no menu
Alojamentos{.action} e escolha o alojamento web em causa.
{.thumbnail}
Etapa 3
Na página que se abrir, clique no separador
Mais{.action} e, a seguir, emCron{.action}.Etapa 4
Na tabela que aparece, clique no botão
...{.action} situado à direita da tarefa planeada em causa.Escolha entre os botões
Alterar{.action} ouEliminar{.action} em função da ação que pretende realizar na tarefa programada.
| Funcionalidade | Descrição |
|---|---|
| Planeamento horário | Reparem que o campo "Minutes" está desativado na interface (definido por "? " na vista crontab). Uma tarefa só pode ser executada uma vez por hora, sendo a frequência de repetição mais baixa que pode ser especificada. |
| Duração | A duração de execução de uma tarefa é de 60 minutos. Se um script ultrapassar este tempo de execução, será automaticamente interrompido pelo sistema. |
| Variáveis | Apenas pode definir variáveis num script. Adicioná-las ao URL que chama o script não funcionará (Exemplo: www/jobs/cron.php?variável=value). |
| Limite de dados | Uma tarefa só pode gerar 5 MB de dados (stdin/stderr). Por exemplo, se um script escrever dados num ficheiro .txt, a execução será automaticamente interrompida quando o ficheiro atingir 5 MB. |
| Scripts que produzem erros | Se um script falhar, ele será automaticamente desativado após 10 tentativas de execução com falha. O relatório de erro só será enviado quando as 10 tentativas tiverem falhado. Corrija o script em função do relatório de erro recebido e reative a "tarefa CRON" no painel de configuração (clique em ...{.action} e em Alterar{.action}). |
| Relatórios de execução | Os relatórios só serão enviados para o endereço eletrónico selecionado uma vez por dia (durante as horas noturnas). |
Um teste simples para ver se o script vai produzir um erro é executá-lo num browser. Por exemplo, se o caminho de acesso do seu script for "www/cron.php" e o seu domínio de alojamento for "mypersonaldomain.ovh", deve utilizar o URL "http://mypersonaldomain.ovh/cron.php". Se não aparecer nenhum erro, mas o script não funcionar como previsto, siga as sugestões abaixo.
Tenha o cuidado de utilizar caminhos de acesso absolutos aos ficheiros dos seus scripts. A constante "DIR", por exemplo, pode ajudar a receber o caminho corrente nos scripts PHP (documentação PHP{.external}).
No [logs] do seu alojamento Web, acessível a partir da sua Área de Cliente OVHcloud{.external}, poderá ver a categoria de log intitulada "CRON".
Para mais informações, consulte o nosso guia "Consultar as estatísticas e os logs do meu site alojado numa oferta partilhada".
- Exemplo de fim de script corretamente executado
[2023-08-11 00:36:01] ## OVH ## START - 2023-08-11 00:36:01.524384 executing: /usr/local/php7.2/bin/php /homez.161/myftpusername/www/myscript.sh
[2023-08-11 00:36:01]
[2023-08-11 00:36:01] ## OVH ## END - 2023-08-10 22:39:44.086166 exitcode: 0
- Exemplo de insucesso devido a ultrapassagem do tempo de execução
[2023-08-11 00:36:01] ## OVH ## START - 2023-08-11 00:36:01.524384 executing: /usr/local/php7.2/bin/php /homez.161/myftpusername/www/sleep.sh
[2023-08-11 01:36:01] ## OVH ## ERROR - CRON TASK INTERRUPTED BY OVH - reason: your script duration exceeded the maximum permitted (3600 seconds)
[2023-08-11 01:36:01] ## OVH ## END - 2023-08-11 01:36:01.086166 exitcode: 0
- Exemplo de falha porque o ficheiro de script não pode ser encontrado no caminho de acesso especificado
[2023-08-11 00:36:01] ## OVH ## START - 2023-08-11 00:36:01.524384 executing: /usr/local/php7.2/bin/php /homez.161/myftpusername/www/noscript.sh
[2023-08-11 00:36:01] ## OVH ## ERROR command '/homez.161/myftpusername/www/noscript.sh' not found
[2023-08-11 00:36:01] ## OVH ## END - 2023-08-11 00:36:01.086166 exitcode: 255
- Exemplo de falha devido a um erro de autorização (chmod) ou a uma configuração incorreta do ficheiro .ovhconfig
[2023-08-11 18:07:10] ## OVH ## Your job could not be initiated for an unknown reason.
[2023-08-11 18:07:10]
[2023-08-11 18:07:10] ## OVH ## END - 2023-08-11 18:07:10.969840 exitcode: 255
Configurar o ficheiro .ovhconfig do alojamento web
Utilizar o acesso SSH do seu alojamento web
Para serviços especializados (referenciamento, desenvolvimento, etc), contacte os parceiros OVHcloud.
Se pretender usufruir de uma assistência na utilização e na configuração das suas soluções OVHcloud, consulte as nossas diferentes ofertas de suporte.
Fale com nossa comunidade de utilizadores.