Configurar, Implantar e Testar o Aplicativo Web

Um aplicativo web foi configurado para apontar para a rede Blockchain e o bucket usado como exemplo neste manual da solução. Atualize os detalhes para usar este aplicativo que aponta para sua Rede Blockchain e bucket.

Faça download do aplicativo Web em GitHub aqui: Exemplo de aplicativo Web.

Importar o Aplicativo Web para o Oracle Visual Builder Studio

O Oracle Visual Builder Studio não é usado apenas para desenvolver aplicativos Visual Builder, mas permite o desenvolvimento de qualquer tipo de aplicativo moderno, graças à sua infinidade de ferramentas de desenvolvimento integradas, como repositório GIT, mecanismo de pipelines CI/CD, geração de artefatos, repositório de contêineres, ferramentas ágeis, ferramentas de criação de equipe e muito mais.

1. Acesse o menu de navegação da console web do Oracle Cloud, vá para OCI Classic Services e clique em Desenvolvedor.
2. Clique no ícone da instância do Oracle Visual Builder Studio e, em seguida, clique em Acessar Instância de Serviço.

   Observação:

   Caso não haja instância existente, crie uma nova instância, aguarde até que ela seja criada e acesse-a. Salve o URL desta instância do Visual Builder Studio, pois ele será usado nas próximas etapas.
3. Para criar um novo projeto, clique em + Criar na página padrão (Organização).
4. Informe um Nome de projeto e clique em Próximo.
5. Como importaremos um Aplicativo Visual Builder existente como um Modelo de Projeto, selecione a opção Esvaziar Projeto e clique em Próximo.
6. Na última tela do assistente, deixe o idioma de marcação wiki padrão e clique em Finalizar. O novo projeto será criado em cerca de 5 minutos.
7. Depois que o projeto for criado, a página principal do projeto será mostrada. Antes de importarmos nosso aplicativo, precisamos ter um ambiente para configurá-lo e executá-lo temporariamente. Clique em Criar Ambiente.
8. Informe um Nome do Ambiente, uma Descrição e clique em Criar.
   Se já houver alguma instância do Visual Builder na tenancy, adicione-a a esse ambiente clicando em Adicionar Instância. Se você não tiver nenhuma instância do Visual Builder, provisione uma e retorne a esta etapa para adicionar a instância ao ambiente.
9. Selecione sua instância do Visual Builder e clique em Adicionar.
10. Depois que o ambiente tiver sido adicionado ao projeto, crie o Espaço de Trabalho, no qual poderemos importar o aplicativo Web pré-criado. Selecione a opção de menu Espaços de Trabalho no menu de navegação esquerdo.
11. Um espaço de trabalho pode ser criado importando nosso aplicativo Web Visual Builder para o projeto. Clique em Importar.
12. No assistente, forneça os seguintes detalhes:
    • O arquivo zip do aplicativo Web pré-criado do Visual Builder.
    • Um nome para o espaço de trabalho.
    • Selecione o ambiente configurado anteriormente no projeto a ser usado para testar o aplicativo.
    • Crie um novo repositório Git vazio e dê a ele um nome e um nome de ramificação padrão.
13. Clique em Importar.

Configurar o Aplicativo Web para apontar para sua instância do Blockchain

Nesta seção, configuraremos o aplicativo web fornecido para apontar para a Instância Blockchain criada na seção anterior.

Anote as seguintes informações da rede Blockchain que você criou:

• Ponto final de BC
• Nome da instância
• Canal
• Chaincode

1. Acesse a instância do Visual Builder Studio e abra o projeto criado clicando no nome do projeto na página padrão em que você acessa (Organização) ao acessar o Visual Builder Studio.
2. Selecione o Espaço de Trabalho criado ao importar o aplicativo Web e, em seguida, selecione o Aplicativo Web conforme mostrado na imagem e nas etapas a seguir.
   
   
   Descrição da ilustração oci-vbs.png
   
   
   1. Selecione a Seção Aplicativo Web.
   2. Selecione o Aplicativo Web.
3. Vá para a guia Variáveis e altere o valor padrão das variáveis bcEndpoint, bcInstance, chaincode e channel clicando no símbolo f(x) no canto superior direito do atributo Valor Padrão para cada uma das variáveis.

Configurar o Aplicativo Web para apontar para o Bucket do Object Storage

Nesta seção, configuraremos o bucket do Object Storage a ser usado pelo Aplicativo Web com base nos valores da Chave de API e do Bucket que você criou antes.

1. Acesse a instância do Visual Builder Studio e abra o projeto criado clicando no nome do projeto na página padrão em que você acessa (Organização) ao acessar o Visual Builder Studio.
2. Selecione a seção Conexão de Serviços e selecione a Conexão de Serviço fileUpload.
3. Vá para a guia Servidores e, no lado direito da configuração do servidor, clique no ícone de Lápis para alterar a configuração da conexão de serviço fileUpload.
   A configuração da Conexão de Serviço usada para interagir com nosso bucket precisa ser adaptada em três lugares.
4. Na tela Editar Servidor, atualize os seguintes campos:
   • URL da Instância: Ele precisa ser alterado para apontar para seu bucket com base em algumas propriedades da tenancy do OCI e no nome que você deu ao bucket quando o criou. O URL deve ser composto com base no seguinte modelo de URL:

     https://objectstorage.<region-name>.oraclecloud.com/n/<storage-namespace>/b/<bucket-name>

   • Autenticação: Certifique-se de que o método de autenticação esteja definido como Assinatura da API do Oracle Cloud Infrastructure 1.0 e a chave seja definida clicando no ícone de Lápis no lado direito da propriedade Id da Chave.

     Observação:

     O ID da Chave é composto com base no seguinte modelo:

     <Tenancy-OCID>/<User-OCID>/<Key-Fingerprint>
     

     Todos esses valores podem ser acessados na Visualização do Arquivo de Configuração obtida quando a Chave de API foi criada durante a configuração do OCI Bucket Storage. Chave Privada é a chave privada que usamos, geramos ou baixamos (dependendo da opção selecionada) durante a criação da Chave de API.
   • Tipo de Conexão: Deve ser definido como Dinâmico, o serviço suporta CORS.

   Depois que essas três propriedades tiverem sido configuradas corretamente de acordo com seu Bucket e sua Chave de API, o Aplicativo Web estará completamente pronto para interagir com seu Bucket de Armazenamento. Você pode continuar testando seu Aplicativo Web.

Testar seu Aplicativo Web

Agora você pode testar o aplicativo no ambiente Visual Builder configurado em nosso projeto. Se tudo funcionar bem, poderemos avançar e exportar o Aplicativo Web para ser implantado em uma configuração independente.

Este Aplicativo Web interage com os dois backends usados na solução: Blockchain para armazenar as pastas e os metadados do documento e os buckets de armazenamento do OCI para o conteúdo do documento. Então, vamos testar algumas funcionalidades garantindo que ambos os backends (Blockchain e Bucket) sejam acessíveis através do Aplicativo Web.

1. Para testar o aplicativo, clique no ícone Visualizar no canto superior direito do Espaço de Trabalho do Visual Studio.
2. Faça log-in no aplicativo como um gerenciador de pastas, o usuário poderá acessar as pastas para as quais é o proprietário atual ou criar uma nova pasta, para a qual será o guardião atual, podendo adicionar mais documentos à pasta ou transferir a pasta inteira para outro usuário ou departamento.
   Vamos tentar criar uma pasta e fazer upload de um documento para ela.
3. Faça log-in como um dos usuários (cmsleg001, cmsfin001 ou cmsrsk001) garantindo que a atribuição seja definida como Gerenciador de pastas e clique em Fazer Log-in.
4. Na página Gerenciamento de Pastas, clique em Nova pasta.
5. Atribua valores aos três campos de entrada (Tipo de pasta, Descrição e ID do Cliente) e clique em Criar pasta.
6. Na console do Oracle Blockchain Service, navegue até a guia Canais, selecione o canal wedocms e verifique o conteúdo no último bloco salvo no razão. Ela deve conter a solicitação para executar a transação que acabamos de executar.
7. Para testar se podemos fazer upload de um documento na pasta recém-criada, selecione a pasta e clique em Fazer Upload de Documentos.
8. Se não houver nenhum documento carregado nesta pasta, clique em Fazer Upload de um Novo Documento.
9. Selecione um Tipo de Documento, informe um Nome de Documento, selecione um arquivo ou solte um arquivo PDF na Área Arrastar e Soltar, adicione Propriedades Dinâmicas e clique em Fazer Upload do Documento.

Podemos verificar na console do Oracle Blockchain se essa nova transação foi executada e também se o upload do documento foi feito no Bucket de Armazenamento do OCI. Faça login como um revisor de documentos, qualquer usuário que tenha acesso ao aplicativo poderá revisar documentos carregados de qualquer pasta.

Exportar o aplicativo para ser executado em uma máquina autônoma

As etapas a seguir descrevem como exportar o aplicativo e fazer download do pacote exportável a ser implantado fora do Visual Builder.

Um aplicativo Visual Builder, se atender a algumas condições, poderá ser executado fora do contexto do Visual Builder. Para obter mais informações, consulte os seguintes blogs: Executando Aplicativos do Visual Builder em Outros Servidores (e Locais) e Executando Aplicativos do Visual Builder Fora do Visual Builder.

1. Para exportar o aplicativo, envie as alterações para o Git Repository. Clique no menu Repo/Filial do Git no lado superior esquerdo do Espaço de Trabalho e selecione a opção Enviar.
2. Informe uma mensagem de commit e clique em Confirmar Tudo e Enviar Push.
   Na primeira vez que esse job for executado, poderá levar vários minutos aguardando um Executor de Build, mas depois que o Executor de Build pegar o job, ele deverá ser executado em cerca de 3 minutos e uma mensagem pop-up de push bem-sucedida do Git deverá ser exibida.
3. Neste momento, podemos publicar nosso aplicativo e essa ação acionará um job de build para otimizar o aplicativo a ser executado nas melhores condições. Clique em Publicar no canto superior direito da página Espaço de Trabalho.
4. Na caixa de diálogo Publicar Alterações, selecione Intercalar Agora ou Intercalar Após Revisão e clique em Publicar.
5. Informe suas credenciais e clique em Adicionar Credenciais e Continuar.
6. Na janela pop-up Criação iniciada, clique em Abrir job.
7. Clique em Artefatos para exibir o pacote gerado.
8. Clique em built-assets.zip para fazer download do pacote, de modo que o pacote exportável esteja pronto para ser implantado fora do Visual Builder.

Executar o pacote exportado em um Servidor Apache Tomcat

O pacote built-assets.zip pode ser implantado para ser servido diretamente por um Servidor Apache Tomcat.

1. Instale o Servidor Apache Tomcat, uma vez instalado, inicie-o e verifique se ele funciona tentando acessar o URL: http://localhost:8080.
2. Nosso aplicativo pode ser instalado no Tomcat descompactando o pacote built-assets.zip e copiando o conteúdo do zip para uma nova pasta criada dentro da pasta /webapps.
3. Depois que o aplicativo for implantado na pasta webapps de nossa instalação do Tomcat, poderemos reiniciar o Tomcat e tentar acessar o seguinte URL: http://localhost:8080/<folder-name-inside-webapps>/webApps/docmngmt/
   Agora podemos testar o aplicativo em nosso ambiente local.