Nesta página, descrevemos como criar
filas do Cloud Tasks
usando o comando gcloud
da CLI gcloud.
Antes de começar
Os nomes de fila consistem em três partes: um ID do projeto, um local e um ID de fila. Para todos os tipos de destino, você precisa ter um projeto do Google Cloud que fornece o ID do projeto.
Se estiver usando tarefas de destino do App Engine, você também precisará ter um aplicativo do App Engine. O aplicativo está localizado em uma região específica e essa região serve como parte do local do nome da fila. Portanto, anote essa informação ao adicionar o aplicativo. Esse é o local onde sua fila e seus gerenciadores serão executados.
O uso de tarefas de HTTP Target, por outro lado, não requer um aplicativo do App Engine. Você seleciona um local do Google Cloud ao criar a fila.
Criar uma fila do Cloud Tasks
Use o Google Cloud SDK para criar sua fila:
gcloud tasks queues create QUEUE_ID --location=LOCATION
Substitua:
LOCATION
: o local em que a fila é executada, por exemplo,europe-west4
.- Se a organização
restringir o local do recurso e você quiser criar uma fila em
us-central1
ouus-central2
, a política da organização precisará permitir a criação de filas emus-central1
eus-central2
, mesmo que você só precise de uma fila em uma dessas regiões.
- Se a organização
restringir o local do recurso e você quiser criar uma fila em
QUEUE_ID
: o identificador que você atribui à sua fila, por exemplo,my-queue
.
Pode demorar alguns minutos para que uma fila recém-criada esteja disponível. Em seguida, use
describe
para verificar se a fila foi criada com sucesso:
gcloud tasks queues describe QUEUE_ID --location=LOCATION
Substitua:
QUEUE_ID
: o ID da fila (nome curto)LOCATION
: o local da fila.
A saída será semelhante a esta:
name: projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID rateLimits: maxBurstSize: 100 maxConcurrentDispatches: 1000 maxDispatchesPerSecond: 500.0 retryConfig: maxAttempts: 100 maxBackoff: 3600s maxDoublings: 16 minBackoff: 0.100s state: RUNNING
Se a saída anterior não aparecer, tente o seguinte:
- Aguarde pelo menos um minuto para que a fila seja inicializada.
Verifique se já há uma fila com o mesmo código. Veja as filas no seu projeto chamando:
gcloud tasks queues list --location=LOCATION
Para pesquisar vários locais, é necessário fazer várias solicitações.
Verifique se você atingiu o limite da fila:
Acessar a página da API do Cloud Tasks
e selecione Cotas.
Para aumentar os limites de recursos, selecione Editar cotas na página "Cotas" do console do Google Cloud.
Verifique cada parte do comando e o execute novamente.
A seguir
- Saiba mais sobre como configurar filas do Cloud Tasks.
- Saiba mais sobre o gerenciamento de filas na referência da API RPC.
- Saiba mais sobre o gerenciamento de filas na referência da API REST.
- Consulte a lista completa de comandos
gcloud
do Cloud Tasks.