O assistente de instalação de apps segue três passos: configure a conta de administrador e as definições do site, reveja o que está prestes a acontecer, depois veja a instalação correr e recolha os seus detalhes de início de sessão.
Antes de Começar
Precisa de uma coisa: um site ativo na sua conta. O assistente instala num site que já tem, não cria um. Se não tiver nenhum, o assistente avisa e fornece uma ligação para criar um. Consulte Criar o Seu Primeiro Site.
Também precisa da permissão apps:write, que é detida pelos Proprietários e Administradores da conta.
Faça uma cópia de segurança antes de instalar num site que já tem conteúdo. O assistente tem uma rede de segurança para um site que já possui uma app, descrita abaixo, mas um ponto de restauro manual tomado deliberadamente vale sempre mais do que um tomado automaticamente. Consulte Fazer uma Cópia de Segurança.
Aceder ao Assistente
- Clique em Apps na barra lateral do KPanel.
- Clique na app que pretende.
- Clique em Instalar [app] no painel à direita.
O endereço direto é /apps/<app-slug>/install.
Passo 1: Configurar
O assistente mostra a app, depois quatro grupos de campos. Um aviso Recomenda-se atualização do plano aparece no topo se a app sugerir um nível de plano superior ao que tem: é um conselho, e a instalação continua mesmo assim.
Localização
Instalar no site. Escolha entre os seus sites ativos. É aqui que a app vai residir.
Conta de Administrador
- Nome de utilizador de administrador. Predefinido para
admin. Este é o nome de utilizador com que vai iniciar sessão, e pode adicionar mais utilizadores depois. - Palavra-passe de administrador. Uma palavra-passe forte de 16 caracteres é gerada para si no momento em que a página carrega. Mostrar revela-a e Gerar cria uma nova. Também pode escrever a sua própria; deve ter pelo menos 8 caracteres.
- Email de administrador. Opcional. Utilizado para início de sessão e reposição de palavra-passe. Se deixado em branco, o seu email de conta é utilizado.
Guarde a palavra-passe de administrador antes de sair do assistente. É mostrada no ecrã de revisão e novamente no ecrã de sucesso, e depois desaparece. O KapsuleHost não armazena uma cópia que possa recuperar mais tarde, portanto perder significa repor a palavra-passe através da própria app.
Definições do Site
- Nome do site, quando a app pede um.
- Idioma. O idioma em que a app está configurada, escolhido entre dezasseis opções incluindo English (US), English (UK), Te Reo Māori, e os principais idiomas europeus e asiáticos. Isto define o idioma do conteúdo da própria app, não do KPanel.
Base de Dados
Mostrado apenas para apps que precisem de uma. O assistente sugere um nome de base de dados derivado do seu domínio. Apenas letras e números, sem sublinhados ou hífenes: o campo força isto enquanto digita. Mude se quiser.
As apps que precisam de uma base de dados têm-na aprovisionada automaticamente como parte da instalação.
Algumas apps adicionam os seus próprios campos extra abaixo deste, definidos pela própria app, com texto de ajuda quando aplicável. Os campos obrigatórios são marcados com um asterisco, e Continuar permanece desativado até que todos estejam preenchidos.
Na parte inferior o assistente mostra o resumo de recursos para esta app: tempo de instalação esperado, RAM mínima, e se uma base de dados é adicionada.
Clique em Continuar.
Passo 2: Rever e Confirmar
O ecrã de revisão reafirma as decisões numa lista: app, site, nome do site, nome de utilizador de administrador, palavra-passe de administrador (com um botão de mostrar ou ocultar), email de administrador, idioma e nome da base de dados. O subtítulo diz claramente: nada é instalado até confirmar.
- Editar volta para mudar algo.
- Confirmar e instalar inicia o trabalho.
Use o ecrã de revisão para o controlo que mais importa: a linha Site. Instalar no site errado é o erro de instalação mais comum, e é o que a proteção de sobrescrita abaixo existe para apanhar.
Passo 3: Instalar
O assistente muda para uma vista de progresso. Vai ver, por ordem:
- Na fila: à espera de worker. O seu trabalho está na fila e começará em breve.
- Instalando [app], com segundos decorridos em relação ao tempo de instalação típico e uma barra de progresso.
Deixe a página aberta. A instalação continua em segundo plano se navegar para outro lado, mas perde a vista ao vivo e o resumo de credenciais no fim.
Se a instalação encontrar um problema, tenta automaticamente, mostrando Tentar novamente a instalação com o número da tentativa. Se demorar muito para além do tempo esperado, uma nota aparece oferecendo continuar à espera ou cancelar.
Cancelar
Cancelar instalação para o trabalho. O ecrã de resultado confirma: A instalação foi parada. Nada foi alterado no seu site.
Quando o Site Já Tem uma App
Se o diretório do site alvo já contém um site, a instalação para com um aviso nomeando o que encontrou:
Este diretório já contém [app]. Instalar [nova app] vai SOBRESCREVÊ-lo e não pode ser desfeito. Uma cópia de segurança completa do seu site atual será feita primeiro para que possa restaurá-lo.
Duas opções: cancelar, ou Fazer cópia de segurança e sobrescrever. Se consentir, o trabalho faz uma cópia de segurança completa do site existente antes de escrever algo, portanto existe um ponto de restauro.
Este é o ponto de não retorno no assistente. A sobrescrita substitui os ficheiros do site existente. A cópia de segurança automática significa que é recuperável, não que é reversível com um clique. Se não tiver a certeza de que o site é descartável, cancele e instale num site diferente em vez disso.
Apps que a Nossa Equipa Instala Manualmente
Algumas apps não têm um instalador automático comprovado. Para estas o assistente salta a barra de progresso inteiramente e mostra uma confirmação acolhedora em vez disso:
Estamos a configurar [app] para si. Esta app precisa de uma configuração manual, portanto a nossa equipa instala-a no seu site para si após encomendar. Vamos enviar-lhe um email no momento em que fica ao vivo; não há mais nada que precise fazer.
Nada falhou e nada está pendente em si. As apps são gratuitas, portanto não há cobrança de qualquer forma.
Passo 4: Está ao Vivo
No sucesso o assistente mostra [app] está ao vivo, uma ligação para o seu domínio, e o resumo de credenciais:
- Nome de utilizador de administrador
- Palavra-passe de administrador, com mostrar ou ocultar
- Email de administrador
- Título do site
Também mostra o registo de instalação, linha por linha, com cada passo marcado como bem-sucedido, falhado ou ignorado. Esse registo vale a pena dar uma olhadela mesmo numa instalação limpa: diz-lhe exatamente o que foi configurado.
Dois botões terminam o fluxo: Abrir [app] vai diretamente para a app, e Voltar para App retorna à página de catálogo.
E Se Falhar
Instalação Falhada. O ecrã de resultado mostra o que aconteceu e afirma a parte importante: Qualquer mudança parcial foi revertida. O seu site está limpo. Duas ações são oferecidas, Tentar Novamente e Contactar Suporte.
Causas comuns e o que fazer:
- Limites de recursos. Se a RAM mínima da app for superior àquela que o seu plano lhe dá, a instalação pode falhar a meio do caminho. Verifique a figura Min RAM na página da app. Consulte Atualizar o Seu Plano.
- Um campo rejeitado. O assistente recusa entrada contendo caracteres não seguros para shell antes do trabalho ser sequer enfileirado, e nomeia o campo. Simplifique o valor: um nome de utilizador simples, uma palavra-passe gerada, um nome de base de dados com letras e números.
- O site não está ativo. Apenas sites com estado ATIVO aparecem na lista pendente de site. Um site ainda em provisionamento não será listado.
A instalação foi bem-sucedida mas o site mostra um erro. Verifique o registo de instalação para um passo falhado, depois verifique a própria documentação da app para configuração pós-instalação. As apps de comunidade em particular frequentemente precisam de um assistente de configuração final executado no navegador. Consulte Site Não Carrega.
Perdeu a palavra-passe de administrador. Use a reposição de palavra-passe da própria app com o email de administrador que definiu. Para WordPress especificamente, consulte Repor uma Palavra-passe WordPress.
A instalação está presa em Na fila. A fila de trabalho está ocupada. Começará. Se ainda estiver na fila muito para além do tempo de instalação esperado, cancele e tente novamente, depois abra um ticket de suporte se se repetir.