Gerenciando projetos

Saiba como criar e trabalhar com projetos.

O que é um projeto?

Um projeto é um agrupamento de entidades do Code Engine como aplicativos, tarefas e construções. Um projeto é baseado em um namespace do Kubernetes. O nome de seu projeto deve ser exclusivo dentro de seu grupo de recursos, sua conta do usuário e sua região do IBM Cloud®. Os projetos são usados para gerenciar recursos e fornecer acesso às suas entidades.

Um projeto fornece os itens a seguir.

Fornece um namespace exclusivo para nomes da entidade.
Gerencia o acesso aos recursos do projeto (acesso de entrada).
Gerencia o acesso a serviços de apoio, registros e repositórios (acesso de saída).
Tem um certificado gerado automaticamente para o Transport Layer Service (TLS).

Para obter mais informações sobre como gerenciar o controle de acesso a projetos com o IAM, consulte Gerenciando o acesso de usuário.

Os projetos não incorrem em custos, mas em vez disso servem como pastas para seus apps, tarefas e funções.

Como é possível ver a quais projetos tenho acesso?

É possível ver uma lista de seus projetos no Console do Code Engine.

Também é possível executar o comando project list.

ibmcloud ce project list

Saída de exemplo

Getting projects...
OK

Name             ID                                    Status  Selected  Tags  Region    Resource Group  Age
myproj-eude      01234567-abcd-abcd-abcd-abcdabcd2222  active  false           eu-de     default         27d
myproject        01234567-abcd-abcd-abcd-abcdabcd1111  active  true            us-south  default         52d

Como é possível ver detalhes sobre um projeto?

No console do Code Engine, é possível ver detalhes de um projeto clicando no nome de um projeto na página Code Engine Projects.

Quando você estiver trabalhando com um componente no Code Engine no console, como apps, tarefas, ou funções, ou suas entidades relacionadas, como acesso, ligações ou assinaturas, é possível visualizar detalhes sobre o projeto associado. Na página da entidade específica Code Engine, clique em Detalhes para saber mais sobre o projeto associado. Use esta página para visualizar detalhes do projeto associado, que inclui informações como a região, CRN (Cloud Resource Name), GUID (identificador exclusivo global), endereços de rede (públicos e privados) e muito mais!

Também é possível executar o comando project get para exibir detalhes de um projeto. Substitua PROJECT_NAME pelo nome de seu projeto. Se o seu projeto for selecionado como o contexto atual, a saída deste comando incluirá detalhes sobre limites e uso de cota de recursos do projeto Code Engine. Para obter mais informações sobre limites para projetos, consulte Cotas de projeto.

ibmcloud ce project get --name PROJECT_NAME

Saída de exemplo

Getting project 'myproject'...
OK

Name:                       myproject
ID:                         01234567-abcd-abcd-abcd-abcdabcd1111
Status:                     active
Selected:                   true
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500

Quotas:
    Category                                  Used       Limit
    App revisions                             33         100
    Apps                                      10         100
    Build runs                                4          100
    Builds                                    4          100
    Configmaps                                7          100
    CPU                                       6.15       64
    Ephemeral storage                         5415750Ki  256G
    Instances (active)                        6          250
    Instances (total)                         9          2500
    Job runs                                  4          100
    Jobs                                      3          100
    Memory                                    26400M     256G
    Secrets                                   21         100
    Subscriptions (cron)                      1          100
    Subscriptions (IBM Cloud Object Storage)  0          100

Como é possível configurar políticas para que outros possam trabalhar com meu projeto?

Consulte informações sobre como gerenciar o acesso de usuário para aprender a configurar políticas do IAM para que outros possam trabalhar com seu projeto do Code Engine.

Há limites de projeto a serem considerados?

O número máximo de projetos que é possível criar por região é 20. Para obter mais informações sobre limites para projetos, consulte Cotas de projeto.

Criar um projeto

É possível criar um projeto por meio do console ou com a CLI.

Criando um projeto por meio do console

Na página Projetos do no console do Code Engine, clique em Criar. Como alternativa, é possível criar seu projeto ao criar seu app, tarefa ou função Code Engine com o atalho do console do Code Engine. No Console do Code Engine., selecione Vamos embora. e clique em Criar projeto na página Iniciar criação.
Escolha um local para implementar o projeto.
Insira um nome para o projeto. O nome deve ser exclusivo para todos seus projetos dentro do local especificado.
Escolha o grupo de recursos no qual deseja criar o projeto.
Clique em Criar.

Para visualizar a instância de serviço para o recurso do projeto, acesse o painel do IBM Cloud e localize o nome do projeto no Code Engine.

Criando um projeto com a CLI

Ao criar um projeto, ele é selecionado automaticamente como o contexto atual. Para criar um projeto que não seja selecionado automaticamente, use a opção --no-select.

Instale a CLI do Code Engine. Aponte como destino o grupo de recursos que você deseja usar para o projeto.
Crie um projeto com o comando project create. Use um nome de projeto que seja exclusivo para sua região.
```
ibmcloud ce project create --name PROJECT_NAME
```
Saída de exemplo
```
Creating project 'myproject'...
OK
```

Verifique se seu novo projeto foi criado com o comando project get.

ibmcloud ce project get --name PROJECT_NAME

Saída de exemplo

Getting project 'myproject'...
OK
Name:                       myproject
ID:                         01234567-abcd-abcd-abcd-abcdabcd1111
Status:                     active
Selected:                   true
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500

Quotas:
Category                                  Used      Limit
App revisions                             1         100
Apps                                      1         100
Build runs                                0         100
Builds                                    0         100
Configmaps                                2         100
CPU                                       1.025     64
Ephemeral storage                         902625Ki  256G
Instances (active)                        1         250
Instances (total)                         2         2500
Job runs                                  1         100
Jobs                                      1         100
Memory                                    4400M     256G
Secrets                                   5         100
Subscriptions (cron)                      0         100
Subscriptions (IBM Cloud Object Storage)  0         100

Também é possível listar todos os projetos e essa saída exibirá qual projeto é o selecionado. No exemplo a seguir, myproject é o projeto selecionado como o contexto atual.

ibmcloud ce project list

Saída de exemplo

Getting projects...
OK

Name             ID                                    Status  Selected  Tags  Region    Resource Group  Age
myproj-eude      01234567-abcd-abcd-abcd-abcdabcd2222  active  false           eu-de     default         27d
myproject        01234567-abcd-abcd-abcd-abcdabcd1111  active  true            us-south  default         52d

Trabalhar com um projeto

Depois de criar um projeto, é possível trabalhar com ele usando o console ou a CLI do Code Engine.

Trabalhando com um projeto por meio do console

Para trabalhar com um projeto, acesse o Página Projetos Code Engine e clique no nome do projeto na lista.

Para trabalhar com componentes do Code Engine, deve-se fazer isso no contexto de um projeto. No contexto de seu projeto, é possível criar e trabalhar com componentes Code Engine, como aplicativos, tarefas ou funções. Para determinar o projeto do qual você está trabalhando atualmente, consulte a trilha de navegação do componente do Code Engine.

Trabalhando com um projeto com a CLI

Para trabalhar com um projeto com a CLI, o projeto deve ser selecionado como o contexto atual. Um projeto é selecionado automaticamente como o contexto atual quando ele é criado, a menos que você especifique a opção --no-select. Para selecionar um projeto que não seja atualmente visado, use o comando project select.

ibmcloud ce project select --name PROJECT_NAME

Saída de exemplo

Selecting project 'myproject'...

No contexto do projeto selecionado, é possível trabalhar com componentes do Code Engine, como aplicativos, tarefas ou funções.

Determinando qual projeto é selecionado como o contexto atual

É possível localizar detalhes sobre o projeto que está selecionado como o contexto atual usando o comando project current.

Excluir um projeto

Quando um projeto não for mais necessário, será possível excluí-lo. A exclusão de um projeto exclui todos os componentes que ele contém. É possível usar o console ou a CLI.

Quando você exclui um projeto do console ou com a CLI, ele sofre uma exclusão recuperável e pode ser restaurado. Deve-se restaurar o seu projeto dentro de sete dias ou ele será excluído permanentemente. Para obter mais informações sobre a restauração de projetos, consulte Restaurando projetos excluídos. Para excluir permanentemente um projeto, veja Excluindo projetos permanentemente.

Quando você exclui um projeto, todos os projetos que não são excluídos permanentemente contam para o máximo de 20 projetos totais permitidos por região.

Os nomes de projetos dentro de uma região devem ser exclusivos. Ao realizar a exclusão recuperável de um projeto (ou excluir o projeto com reclamação), não é possível reutilizar o nome do projeto até que o projeto seja excluído permanentemente.

Excluindo um projeto do console

Para excluir um projeto do console, acesse Página Projetos Code Engine, selecione o projeto que deseja excluir e clique no ícone de exclusão. Se você abrir um projeto específico, também será possível excluí-lo por meio do menu Ações.

Quando você exclui um projeto, ele é temporariamente excluído e pode ser restaurado dentro de sete dias antes de ser excluído permanentemente. As recuperações de projetos representam projetos excluídos que ainda podem ser restaurados. Na página Code Engine Página de projetos, o número de recuperações de projeto é exibido. Clique em restorable projects para abrir a página Recuperações de projetos e exibir uma lista de projetos que podem ser restaurados ou excluídos permanentemente

Excluindo um projeto com a CLI

Para excluir um projeto com a CLI, use o comando project delete. É possível, opcionalmente, usar a opção -f para forçar a exclusão de um projeto sem confirmação. Após um projeto ser excluído temporariamente, é possível gerenciar esse projeto com os comandos do reclamation O exemplo a seguir exclui temporariamente o projeto myproject.

ibmcloud ce project delete --name myproject -f

Saída de exemplo

Deleting project 'myproject'...
OK

Para excluir permanentemente um projeto de tal maneira que ele não possa ser restaurado, especifique a opção --hard com o comando project delete. É possível, opcionalmente, usar a opção -f para forçar a exclusão de um projeto sem confirmação. O exemplo a seguir exclui permanentemente o projeto myproject1,

ibmcloud ce project delete --name myproject1 --hard -f

Saída de exemplo

Deleting project 'myproject1'...
OK

Se você especificar a opção --hard com o comando project delete, o projeto será excluído imediatamente e não poderá ser restaurado usando a recuperação de recurso da IBM Cloud. Se você não especificar a opção --hard, o projeto poderá ser restaurado em 7 dias usando o comando reclamation restore.

Se você, anteriormente, excluiu temporariamente um projeto (sem especificar a opção --hard), será possível especificar uma exclusão subsequente apenas usando o comando project delete com a opção --hard. Essa ação exclui completamente o projeto para que ele não possa ser restaurado.

Restaurando projetos excluídos

Restaurando projetos excluídos por meio do console

Depois de excluir um projeto de forma recuperável, é possível restaurá-lo ou excluí-lo permanentemente do console. Deve-se restaurar o seu projeto dentro de sete dias ou ele será excluído permanentemente.

Na página Projetos no Code Engine, visualize a lista de projetos em sua região. O número de recuperações de projetos é exibido.
Clique no link para project reclamations.
A partir da página Recuperações do projeto, é possível visualizar o número de dias restantes que você pode restaurar o seu projeto.
- Para restaurar seu projeto, clique no ícone de restauração.
- Para excluir permanentemente o seu projeto, clique no ícone de exclusão.

Se você não tomar nenhuma ação em relação a um projeto listado na página de Recuperações do projeto, o projeto será automaticamente excluído de forma permanente após 7 dias.

Restaurando projetos excluídos com a CLI

Os projetos que são excluídos temporariamente podem ser gerenciados com os comandos reclamation. Comandos reclamation.

Descubra projetos que foram excluídos temporariamente usando o comando reclamation list.

ibmcloud ce reclamation list

Saída de exemplo

Getting project reclamations...
OK
Name          ID                                    Reclamation ID                        Status        Region    Resource Group  Age   Time to Hard Deletion
myproject     def218c5-abcd-abcd-abcd-97854c288d76  48e3d7a2-abcd-abcd-abcd-99db7152b8fe  soft deleted  us-south  default         40h   6d23h
myproject2    01f0bc66-abcd-abcd-abcd-3ef7e99f6f69  af2cd017-abcd-abcd-abcd-d32e2bb79136  soft deleted  jp-osa    default         8m58s 2d11h

Use o comando reclamation restore para restaurar um projeto excluído temporariamente para um estado ativo. O exemplo a seguir restaura o projeto myproject2 e seus componentes. Certifique-se de ter como alvo a região correta do projeto que deseja restaurar.
```
ibmcloud ce reclamation restore --name myproject
```
Saída de exemplo
```
Restoring project 'myproject'...
OK
```

Como alternativa, é possível usar o comando project restore para restaurar um projeto excluído temporariamente para um estado ativo.

Excluindo projetos permanentemente

Excluindo projetos do console permanentemente

Após realizar a exclusão recuperável de um projeto (ou excluir o projeto com recuperação), é possível restaurá-lo ou excluí-lo permanentemente do console. Quando um projeto é excluído permanentemente, ele não pode ser restaurado.

Na página Projetos no Code Engine, visualize a lista de projetos em sua região. O número de recuperações de projetos é exibido.
Clique no link para project reclamations.
A partir da página Recuperações do projeto, é possível visualizar o número de dias restantes que você pode restaurar o seu projeto. Para excluir permanentemente seu projeto, clique em Delete.

Se você não executar nenhuma ação nos projetos excluídos que estão listados na página Recuperações de projetos, o projeto será excluído de forma automática e permanente após sete dias.

Excluindo permanentemente projetos com a CLI

Se o seu projeto for excluído temporariamente, é possível usar o comando reclamation delete delete para excluí-lo permanentemente. Ao usar a opção --force com este comando, a exclusão é forçada sem confirmação.

ibmcloud ce reclamation delete -n myproject --f

Saída de exemplo

Hard deleting project 'myproject'...
OK

Se o seu projeto não for excluído de forma recuperável, para excluí-lo permanentemente para que ele não possa ser restaurado, use a opção --hard com o comando project delete para especificar a exclusão imediata e permanente do projeto. Por exemplo, para excluir permanentemente o projeto myproject3,

ibmcloud ce project delete --name myproject3 --hard

Saída de exemplo

Deleting project 'myproject3'...
OK