Gerenciamento de esquemas

A solução Cloud Migration Factory na AWS fornece um repositório de metadados totalmente extensível, permitindo que dados para automação, auditoria e rastreamento de status sejam armazenados em uma única ferramenta. O repositório fornece um conjunto padrão de entidades (ondas, aplicativos, servidores e bancos de dados) e atributos no momento da implantação para que você comece a capturar e usar os dados usados com mais frequência e, a partir daqui, você pode personalizar o esquema conforme necessário.

Somente usuários do grupo de administradores do Cognito têm permissões para gerenciar o esquema. Para tornar um usuário membro do administrador ou de outros grupos, consulte Gerenciamento de usuários.

Acesse Administração e selecione Atributos para as guias de entidade padrão. As guias a seguir estão disponíveis para apoiar o gerenciamento da entidade.

Atributos - Permite adicionar, editar e excluir atributos.

Painel de informações - Permite a edição do conteúdo de ajuda do painel de informações. Isso é mostrado à direita da tela das entidades na seção Gerenciamento de migração.

Configurações do esquema - Atualmente, essa guia fornece apenas a capacidade de alterar o nome amigável da entidade, esse é o nome que é mostrado na interface do usuário. Se não for definida, a interface do usuário usará o nome programático da entidade.

Adicionar/editar um atributo

Os atributos podem ser alterados dinamicamente por meio da seção de administração Atributos da solução Cloud Migration Factory na AWS. Quando os atributos são adicionados, editados ou excluídos, as atualizações serão aplicadas em tempo real para o administrador que fizer a alteração. Qualquer outro usuário atualmente conectado à mesma instância terá sua sessão atualizada automaticamente dentro de um minuto após as alterações serem salvas pelo administrador.

Alguns atributos são definidos como atributos do sistema, o que significa que o atributo é fundamental para a funcionalidade principal do Cloud Migration Factory na AWS e, portanto, somente algumas propriedades estão disponíveis para os administradores alterarem. Qualquer atributo que seja um atributo do sistema será exibido com um aviso na parte superior da tela Alterar atributo.

Para atributos definidos pelo sistema, somente o seguinte pode ser editado:

• Painel de informações

• Opções avançadas

  • Agrupamento e posicionamento de atributos

  • Validação de entrada

Todas as outras propriedades do atributo definido pelo sistema são somente leitura.

Adicionar um atributo:

Gerenciamento de atributos

Você pode adicionar novos atributos escolhendo o botão Adicionar na guia de atributos da entidade à qual deseja adicionar o atributo. No exemplo acima, escolher Adicionar adicionará um novo atributo à entidade do banco de dados.

Na caixa de diálogo Alterar atributo, você deve fornecer as seguintes propriedades obrigatórias:

Nome programático - Essa é a chave que será usada para armazenar dados do atributo em relação aos itens na tabela do DynamoDB. Também é referenciado ao usar o Migration Factory APIs e em scripts de automação.

Nome de exibição - Esse é o rótulo que será exibido na interface da web em relação ao campo de entrada de dados.

Tipo - Essa seleção suspensa define o tipo de dados que o usuário poderá armazenar em relação ao atributo. As seguintes opções estão disponíveis:

Tipo	Uso
String	Os usuários podem inserir qualquer linha única de transporte de texto. As devoluções não são permitidas.
String de vários valores	Semelhante a uma string, a única diferença é que o usuário pode inserir vários valores em linhas separadas dentro do campo, que são então armazenados como uma matriz/lista.
Senha	Fornece ao usuário uma forma segura de inserir dados que não devem ser exibidos na tela por padrão. nota Os dados não são armazenados criptografados ao usar esse tipo de atributo e são mostrados em texto não criptografado quando visualizados nas cargas da API, portanto, não devem ser usados para armazenar dados confidenciais. Todas as senhas ou segredos devem ser armazenados no Migration Factory Credential Manager (abordado neste documento), que utiliza o AWS Secrets Manager para armazenar e fornecer acesso às credenciais com segurança.
Data	Fornece um campo com um seletor de data para o usuário selecionar uma data, ou ele pode inserir manualmente a data necessária.
Checkbox	Fornece uma caixa de seleção padrão. Quando marcada, o valor da chave armazenará '`true'; se não estiver marcada, será '`false' ou a chave não existirá no registro.
TextArea	Ao contrário do tipo String que TextAreasfornece a capacidade de armazenar texto de várias linhas, ele suporta somente caracteres de texto básicos.
Tag	Permite que os usuários armazenem uma lista de pares de chave/valor.
Lista	Fornece ao usuário uma lista de opções predefinidas para seleção. Essas opções são definidas na definição do atributo do esquema na propriedade Lista de valores do atributo.
Relacionamento	Esse tipo de atributo fornece a capacidade de armazenar relacionamentos entre quaisquer duas entidades ou registros. Ao definir um atributo de relacionamento, você seleciona a entidade para a qual o relacionamento será e, em seguida, o valor principal usado para relacionar os itens e seleciona o atributo do item relacionado que você deseja exibir para o usuário. O usuário recebe uma lista suspensa com base na entidade e nos valores de exibição disponíveis para o relacionamento. Em cada campo de relacionamento, o usuário tem um link rápido para mostrar o resumo do item relacionado.
JSON	Fornece um campo de editor JSON onde os dados JSON podem ser armazenados e editados. Isso pode ser usado para armazenar parâmetros de entrada/saída do script ou outros dados necessários para automação de tarefas ou qualquer outro uso.

Ao adicionar um novo atributo, você deve conceder aos usuários acesso ao novo atributo por meio de uma política. Consulte a seção Gerenciamento de permissões para obter detalhes sobre como conceder acesso a atributos.

Painel de informações

Fornece a facilidade de especificar ajuda contextual e orientação para o uso do atributo. Quando especificado, o rótulo do atributo na interface do usuário terá um link de informações exibido à direita. Clicar nesse link fornece ao usuário o conteúdo de ajuda e links de ajuda especificados nesta seção à direita da tela.

A seção do painel Informações fornece duas visualizações dos dados, a visualização Editar, na qual você pode definir o conteúdo, e a visualização Visualizar, para fornecer uma visualização rápida do que o usuário verá quando as atualizações do atributo forem salvas.

O título de ajuda é compatível somente com valores de texto sem formatação. O conteúdo de ajuda oferece suporte a um subconjunto de tags html que permitem a formatação de texto. Por exemplo, adicionar tags de <b>início e</b> fim ao redor do texto deixará o texto incluído em negrito (ou seja, ID <b>da interface de rede resultaria em ID</b> da interface de rede). As tags compatíveis são os seguintes:

Tag	Uso	Exemplo de interface do usuário
<p></p>	Define um parágrafo.	<p>Meu primeiro parágrafo</p> <p>Meu segundo parágrafo</p>
<a>	Define um hiperlink.	<a href=” https://aws.amazon.com /">Visite a AWS! </a>
<h3>, <h4>e <h5>	Define os cabeçalhos h3 a h5	<h3>Meu título 3</h3>
<span>	Define uma seção do texto, permitindo a aplicação de formatação adicional, como cor, tamanho e fonte do texto.	<span style="color:blue">azul</span>
<div>	Define uma seção do texto, permitindo a aplicação de formatação adicional, como cor, tamanho e fonte do texto.	<div style="color:blue"> <h3>Este é um título azul </h3> <p>Este é um texto azul em uma div </p> </div>
<ul> + <li>	Define uma lista com marcadores não ordenada.	<ul> <li>Redefinir a hospedagem</li> <li>Redefinir a plataforma</li> <li>Retirar</li> </ul>
<ol>, <li>	Define uma lista ordenada/numerada.	<ol> <li>Redefinir a hospedagem</li> <li>Redefinir a plataforma</li> <li>Retirar</li> </ol>
<code>	Define um bloco ou seção de texto contendo código.	<code>cor de fundo</code>
<pre>	Define um bloco de texto pré-formatado, todas as quebras de linha, tabulações e espaços são gerados.	<pre> Meu texto pré-formatado. Isso é exibido em uma fonte de largura fixa e será exibido conforme digitado <<esses espaços serão mostrados. </pre>
<dl>, <dt> e <dd>	Define uma lista de descrições.	<dl> <dt>Redefinir a hospedagem</dt> <dd>Migração de mover sem alterações (lift-and-shift)</dd> <dt>Retirar</dt> <dd>Desative a instância ou o serviço</dd> </dl>
<hr>	Define uma regra horizontal na página para mostrar uma mudança no tópico ou na seção.	<hr>
<br>	Define uma quebra de linha no texto. São compatíveis, mas não são necessários, pois qualquer devolução de transporte no editor será substituída <br> quando salva.	<br>
<i> e <em>	Definiu o texto incluído em itálico ou formato alternativo localizado.	<i>Isso está em itálico</i> ou <em>Isso também está em itálico</em>
<b> e <strong>	Define o texto incluído em negrito.	<b>Estou em negrito</b> ou <strong>Isso é diferente</strong>

Outra opção disponível para fornecer ajuda são links para conteúdo externo e orientação. Para adicionar um link externo à ajuda contextual do atributo, clique em Adicionar novo URL e forneça um rótulo e um URL. Você pode adicionar vários links ao mesmo tipo de atributo, conforme necessário.

Opções avançadas

Agrupamento e posicionamento

Esta seção fornece ao administrador a capacidade de definir onde na interface de adicionar/editar o atributo será posicionado e também permite o agrupamento de atributos, fornecendo ao usuário uma maneira simples de localizar atributos relacionados.

Grupo de interface do usuário é um valor de texto que define o nome do grupo no qual o atributo deve ser exibido, todos os atributos com o mesmo valor do grupo de interface do usuário serão colocados no mesmo grupo, qualquer atributo sem grupo de interface do usuário especificado será colocado no grupo padrão na parte superior do formulário intitulado Detalhes. Quando o Grupo de UI for especificado, a interface do usuário exibirá o texto mostrado aqui como o título do grupo.

A segunda propriedade nesta seção é Ordem no grupo, que pode ser definida como qualquer número positivo ou negativo e, quando especificado, os atributos serão listados com base em uma classificação do menor para o maior com base nesse valor. Todos os atributos que não tiverem uma ordem no grupo especificada terão prioridade mais baixa e serão classificados em ordem alfabética.

Validação de entrada

Esta seção permite que o administrador defina critérios de validação que garantam que o usuário tenha inserido dados válidos antes de poder salvar um item. A validação usa uma expressão regular ou string regex, que é uma série de caracteres que especificam um padrão de pesquisa para um valor de texto. Por exemplo, o padrão ^ (subnet- ([a-z0-9] {17})) $* pesquisará o texto sub-net- seguido por qualquer combinação dos caracteres de a a z (minúsculas) e dígitos de 0 a 9 com um número exato de caracteres de 17. Se encontrar mais alguma coisa, retornará false indicando que a validação falhou. Neste guia, não podemos abordar todas as combinações e padrões possíveis disponíveis, mas há muitos recursos na internet que podem ajudar a criar a solução perfeita para seu caso de uso. Aqui estão alguns exemplos comuns para você começar:

Padrão Regex	Uso
^(?!\s*$).+	Garante que o valor seja definido.
^(subnet-([a-z0-9]{17})*)$	Verifica se o valor é uma ID de sub-rede válida. [Começa com a sub-rede de texto seguida por 17 caracteres compostos apenas por letras e números]
^(ami-(([a-z0-9]{8,17})+)$)	Verifica se o valor é uma ID de AMI válida. [Começa com a sub-rede de texto seguida por 8 e 17 caracteres compostos apenas por letras e números]
^(sg-([a-z0-9]{17})*)$	Verifica se o valor está em um formato de ID de grupo de segurança válido. [Começa com o texto sg- seguido por 17 caracteres compostos apenas por letras e números]
^ (([a-zA-Z0-9] | [a-zA-Z0-9] [a-zA-Z0-9])\.)([a-zA-Z0-9] | [a-zA-Z0-9] [a-zA-Z0-9\ -] * [a-zA-Z0-9]) $	Garante que os nomes do servidor sejam válidos e contenham apenas caracteres alfanuméricos, hífens e pontos.
^([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|[1-9][0-9][0-9][0-9]|[1][0-6][0-3][0-8][0-4])$	Garante que seja inserido um número entre 1 e 1634.
^(standard|io1|io2|gp2|gp3)$	Garante que a string digitada corresponda a standard, io1, io2, gp2 ou gp3.

Depois de criar seu padrão de pesquisa regex, você pode especificar a mensagem de erro específica que será mostrada ao usuário no campo e insira-a na propriedade da mensagem de ajuda de validação.

Depois que essas duas propriedades forem definidas, na mesma tela, você verá abaixo um simulador de validação. Aqui, você pode testar se seu padrão de pesquisa está funcionando conforme o esperado e se a mensagem de erro foi exibida corretamente. Basta digitar um texto de teste no campo Validação do teste para verificar se o padrão corresponde corretamente.

Exemplo de dados

A seção de dados de exemplo fornece ao administrador a capacidade de mostrar ao usuário um exemplo do formato de dados necessário para um atributo. Isso pode ser especificado para o formato de dados exigido quando fornecido no upload de um formulário de entrada, por meio da interface do usuário e/ou diretamente da API.

Os dados de exemplo mostrados na propriedade de dados de exemplo do formulário de entrada serão gerados em qualquer modelo de entrada criado em que o atributo esteja incluído, ao usar o Download, uma função de formulário de entrada de modelo, em Gerenciamento de migração > Importar.

Os dados de exemplo da interface do usuário e os dados de exemplo da API são armazenados no atributo, mas não estão expostos atualmente na interface da web. Podem ser usados em integrações e scripts.