dotnet run.
Antes de começar
- O .NET SDK na sua máquina. Se ainda não o tiver, baixe-o no site oficial do .NET.
- Uma conta na Square Cloud: cadastre-se com seu e-mail ou GitHub.
- Um plano ativo. Veja os planos e escolha o que combina com o seu projeto.
Configure a Square Cloud
Se você envia sua aplicação pelo dashboard, pode pular esta seção: o dashboard cria o arquivo de configuração
squarecloud.app para você.Referência do arquivo de configuração
O arquivo
squarecloud.app diz à Square Cloud como executar a sua aplicação: o arquivo principal, a memória, a versão do runtime, o nome e, para um site, o subdomínio.MAIN para o arquivo do seu projeto. Um arquivo de configuração completo para cada tipo de aplicação:
- Bot ou worker
- Site ou API
squarecloud.app
O que a Square Cloud executa
- Se o campo
STARTnão estiver definido no arquivo de configuração, a Square Cloud executadotnet restorepara restaurar as dependências do projeto e depoisdotnet run --project MAINpara compilar e executar o projeto especificado emMAIN. Se o campoSTARTestiver definido, o valor nele será executado diretamente. Para mais informações sobre os parâmetros do arquivo de configuração, visite parâmetros de configuração.
Porta e host para sites e APIs
O ASP.NET Core não escuta na porta 80 por padrão, e odotnet run aplica as URLs do Properties/launchSettings.json, que apontam para localhost. Defina o endereço no Program.cs: a Square Cloud define a variável de ambiente PORT como 80, e 0.0.0.0 aceita conexões de fora do container.
Program.cs
Prepare o projeto
Arquivos necessários
squarecloud.app, na raiz do ZIP.- O arquivo do seu projeto (
.csproj) e o código-fonte.
Se o arquivo
.csproj estiver dentro de uma pasta, mantenha o arquivo de configuração na raiz do zip e defina o MAIN com o caminho dele, por exemplo MAIN=folder/file.csproj. O comando padrão primeiro executa dotnet restore na raiz, o que exige um arquivo de projeto ou de solução ali; se a raiz não tiver nenhum dos dois, defina START=dotnet run --project folder/file.csproj.O que deixar de fora
bin/eobj/: saída de build que odotnet runcria de novo no servidor.
Solução de problemas
O site não responde
O site não responde
A aplicação escuta em outra porta ou apenas em
localhost. Defina o endereço com app.Run($"http://0.0.0.0:{port}"), como mostrado em Porta e host.MSB1003: Specify a project or solution file
MSB1003: Specify a project or solution file
O
dotnet restore não encontrou nenhum arquivo de projeto ou de solução na raiz do ZIP. Mova o .csproj para a raiz, ou defina START=dotnet run --project folder/file.csproj.Faça o deploy
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.
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.

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
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.
Via CLI
Para usar esse método, seu projeto precisa de um arquivo de configuração chamadosquarecloud.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 Para enviar um zip que você mesmo criou, passe-o com
squarecloud.ignore lista, e faz o upload:--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.
Próximos passos
Variáveis de ambiente
Mantenha segredos e configurações fora do código e leia-os em tempo de execução.
Domínio personalizado
Sirva a sua aplicação no seu próprio domínio, a partir do plano Standard.
Solução de problemas
Corrija uma aplicação que não inicia ou um site que não responde.

