Tutorial detalhado: conheça os detalhes ao criar o aplicativo de exemplo

Como ativar o registro

1. Navegue até:

   sdk-folder/Samples/PathfindingSample/tools

2. Abra o arquivo do esquema em um editor de texto:

   pathfinding-single-worker-schema.yaml

3. Encontre a seção simulation_properties: no início do arquivo:

   simulation_properties:
     default_entity_index_key_type: "Vector3<f32>"
   

4. Insira as duas linhas a seguir após a linha simulation_properties::

     log_destination_service: "logs"
     log_destination_resource_name: "MySimulationLogs"
   

5. Confirme se a seção simulation_properties: é a mesma que a seguinte:

   simulation_properties:
     log_destination_service: "logs"
     log_destination_resource_name: "MySimulationLogs"
     default_entity_index_key_type: "Vector3<f32>"
   

6. Salve o arquivo e saia do seu editor de texto.

1. Navegue até:

   sdk-folder/Samples/PathfindingSample/tools/cloud

2. Execute um dos seguintes comandos:

   • Docker: python quick-start.py

   • WSL: python quick-start.py --al2

1. Faça o upload do esquema Weaver para o S3.

   • SimSpace Weaver usa um esquema para configurar sua simulação. O esquema é um arquivo de texto simples formatado em YAML. Para obter mais informações, consulte Configurar a simulação.

2. Crie e faça upload de um contêiner personalizado (opcional).

   • Se seu esquema definir um contêiner personalizado, o script de início rápido criará a imagem do docker e a enviará para o Amazon ECR. Para obter mais informações, consulte Contêineres personalizados. Consulte o PythonBubblesSample esquema para ver um exemplo desse recurso.

3. Crie o projeto.

   • quick-start.pychama a build_project função definida embuild.py. Essa etapa variará de acordo com o projeto. Para o PathfindingSample, CMake é usado. O comando CMake e Docker para o qual pode ser encontrado embuild.py.

4. Faça o upload dos artefatos de construção para o S3.

   • Você pode verificar seus buckets do S3 para garantir que todos os uploads tenham sido bem-sucedidos. Para obter informações sobre como gerenciar arquivos com o Amazon S3, consulte Criar, configurar e trabalhar com buckets do Amazon S3 no Guia do usuário do Amazon Simple Storage Service.

   • Os zips do aplicativo de exemplo e o bucket do S3 usam o seguinte formato de nome:

     • weaver-sample-bucket-account-number-region

     • Aplicativo espacial: ProjectNameSpatial.zip

     • Exibir aplicativo (personalizado): ProjectNameView.zip

5. Inicie a simulação.

   • Este é um resumo da aws simspaceweaver start-simulation AWS CLI ligação. Para obter mais informações, consulte a Referência de AWS CLI Comandos para SimSpace Weaver.

   • O script será repetido até que o status da simulação seja STARTED ou FAILED. Poderá levar alguns minutos para que a simulação seja iniciada.

6. Veja os detalhes da simulação.

   • A API DescribeSimulation fornece detalhes sobre a simulação, incluindo o estado. Uma simulação pode estar em um dos seguintes estados:

     Estados do ciclo de vida da simulação

     1. STARTING: estado inicial após chamar StartSimulation

     2. STARTED: todos os aplicativos espaciais são lançados e estão saudáveis

     3. STOPPING: estado inicial após chamar StopSimulation

     4. STOPPED: todos os recursos computacionais estão parados

     5. DELETING: estado inicial após chamar DeleteSimulation

     6. DELETED: todos os recursos atribuídos à simulação são excluídos

     7. FAILED: a simulação teve um erro/falha crítica e foi interrompida

     8. SNAPSHOT_IN_PROGRESS: um snapshot está em andamento

     Como obter os detalhes da simulação

     1. Chame a API ListSimulations.

        aws simspaceweaver list-simulations

        O script deve exibir detalhes sobre cada uma das simulações, semelhantes aos seguintes:

        {
            "Status": "STARTED",
            "CreationTime": 1664921418.09,
            "Name": "MyProjectSimulation_22-10-04_22_10_15",
            "Arn": "arn:aws:simspaceweaver:us-west-2:111122223333:simulation/MyProjectSimulation_22-10-04_22_10_15",
            "TargetStatus": "STARTED"
        }
        

     2. Chame DescribeSimulation para obter os detalhes da simulação. Substitua simulation-name pelo Name da simulação a partir da saída da etapa anterior.

        aws simspaceweaver describe-simulation --simulation simulation-name

        O script deve exibir mais detalhes sobre a simulação que você especificou, semelhantes aos seguintes:

        {
            "Status": "STARTED",
            "CreationTime": 1664921418.09,
            "Name": "MyProjectSimulation_22-10-04_22_10_15",
            "Arn": "arn:aws:simspaceweaver:us-west-2:111122223333:simulation/MyProjectSimulation_22-10-04_22_10_15",
            "TargetStatus": "STARTED"
        }
        

7. Inicie aplicativos personalizados.

   • SimSpace Weaver não gerencia o ciclo de vida de aplicativos personalizados. Você deve iniciar os aplicativos personalizados. É uma prática recomendada iniciar os aplicativos personalizados antes de iniciar o relógio de simulação, mas você também pode fazê-lo depois.

     Você pode chamar a StartApp API para iniciar seus aplicativos personalizados.

     aws simspaceweaver start-app --simulation simulation-name --name app-name --domain domain-name

     A chamada de API StartApp criará e iniciará uma nova instância do aplicativo personalizado usando o nome que você fornecer. Se você fornecer o nome de um aplicativo que já existe, receberá um erro. Se quiser reiniciar um aplicativo específico (instância), primeiro interrompa-o e depois exclua-o.

     nota

     O status da sua simulação deve ser STARTED antes de iniciar aplicativos personalizados.

     O aplicativo de exemplo fornece o aplicativo ViewApp personalizado para visualizar sua simulação. Este aplicativo fornece um endereço IP estático e um número de porta para conectar os clientes de simulação (você fará isso em uma etapa posterior deste tutorial). Você pode pensar em um domain como uma classe de aplicativos com o mesmo código executável e as mesmas opções de inicialização. O app name Identifica a instância do aplicativo. Para obter mais informações sobre SimSpace Weaver conceitos, consulteConceitos-chave para SimSpace Weaver.

     É possível usar a API DescribeApp para verificar o status de um aplicativo personalizado depois de iniciá-lo.

     aws simspaceweaver describe-app --simulation simulation-name --app app-name --domain domain-name

     Como iniciar o aplicativo de visualização neste tutorial

     1. Ligue StartApp paraViewApp.

        aws simspaceweaver start-app --simulation simulation-name --name ViewApp --domain MyViewDomain

     2. Chame DescribeApp para verificar o status do seu aplicativo personalizado.

        aws simspaceweaver describe-app --simulation simulation-name --app ViewApp --domain MyViewDomain

     Depois que o status do seu aplicativo personalizado (instância) for STARTED, a saída de DescribeApp incluirá o endereço IP e o número da porta desse aplicativo personalizado (instância). No exemplo da saída a seguir, o endereço IP é o valor de Address e o número da porta é o valor de Actual no bloco EndpointInfo.

     
     {
         "Status": "STARTED",
         "Domain": "MyViewDomain",
         "TargetStatus": "STARTED",
         "Simulation": "MyProjectSimulation_22-10-04_22_10_15",
         "LaunchOverrides": {
             "LaunchCommands": []
         },
         "EndpointInfo": {
             "IngressPortMappings": [
                 {
                     "Declared": 7000,
                     "Actual": 4321
                 }
             ],
             "Address": "198.51.100.135"
         },
         "Name": "ViewApp"
     }
     
     

     nota

     O valor de Declared é o número da porta à qual o código do seu aplicativo deve ser vinculado. O valor de Actual é o número da porta que é SimSpace Weaver exposta aos clientes para se conectarem ao seu aplicativo. SimSpace Weaver mapeia a Declared porta até a Actual porta.

     nota

     Você pode usar o procedimento descrito em Obtenha o endereço IP e o número da porta de um aplicativo personalizado para obter o endereço IP e o número da porta de qualquer aplicativo personalizado iniciado.

8. Inicie o relógio.

   • Quando você cria uma simulação pela primeira vez, ela tem um relógio, mas ele não está funcionando. Quando o relógio não está funcionando, a simulação não atualiza seu estado. Depois de iniciar o relógio, ele começará a enviar marcações para os aplicativos. A cada clique, seus aplicativos espaciais examinam as entidades que possuem e enviam os resultados para SimSpace Weaver

     nota

     Pode levar de 30 a 60 segundos para iniciar o relógio.

     Chame a API StartClock.

     aws simspaceweaver start-clock --simulation simulation-name

     nota

     A API StartClock usa o simulation-name, que você pode encontrar usando a API ListSimulations:

     aws simspaceweaver list-simulations