A CLI do esquema
Trabalhar com ferramentas de esquema
Como trabalhar com as ferramentas do esquema
Abra o console do CodeCatalyst em https://codecatalyst.aws/
. -
Retome o Ambiente de Desenvolvimento. Para ter mais informações, consulte Retomar um Ambiente de Desenvolvimento .
Caso você não tenha um Ambiente de Desenvolvimento, primeiro será necessário criar um. Para ter mais informações, consulte Criar um Ambiente de Desenvolvimento.
-
Em um terminal em funcionamento, execute o seguinte comando para instalar a CLI do esquema:
npm install -g @amazon-codecatalyst/blueprint-util.cli
-
No arquivo
blueprint.ts
, importe as ferramentas que você deseja usar no seguinte formato:import {
<tooling-function-name>
} from '@amazon-codecatalyst/blueprint-util.cli/lib/<tooling-folder-name>
/<tooling-file-name>
;dica
É possível acessar o
CodeCatalyst blueprints GitHub repository
para encontrar o nome da ferramenta que deseja usar. Se quiser usar a ferramenta de upload de imagens, adicione o seguinte ao script:
import { uploadImagePublicly } from '@amazon-codecatalyst/blueprint-util.cli/lib/image-upload-tool/upload-image-to-aws';
Exemplos
-
Se quiser usar a função de publicação, adicione o seguinte ao script:
import { publish } from '@amazon-codecatalyst/blueprint-util.cli/lib/publish/publish';
-
Se quiser usar a ferramenta de upload de imagens, adicione o seguinte ao script:
import { uploadImagePublicly } from '@amazon-codecatalyst/blueprint-util.cli/lib/image-upload-tool/upload-image-to-aws';
-
-
Chame a função.
Exemplos:
-
Se quiser usar a função de publicação, adicione o seguinte ao script:
await publish(logger, config.publishEndpoint, {
<your publishing options>
}); -
Se quiser usar a ferramenta de upload de imagens, adicione o seguinte ao script:
const {imageUrl, imageName} = await uploadImagePublicly(logger, 'path/to/image'));
-
Ferramenta de upload de imagens
A ferramenta de upload de imagens permite fazer upload da própria imagem em um bucket do S3 na conta da AWS e, depois, distribuir essa imagem publicamente por trás do CloudFront. A ferramenta usa um caminho de imagem no armazenamento local (e o nome opcional do bucket) como entrada e exibe o URL para a imagem que está disponível publicamente. Para ter mais informações, consulte O que é o Amazon CloudFront? e O que é o Amazon S3?
Como trabalhar com a ferramenta de upload de imagens
-
Clone o repositório de esquemas de código aberto no GitHub
que concede acesso ao SDK e a exemplos de esquema. Em um terminal em funcionamento, execute o seguinte comando: git clone https://github.com/aws/codecatalyst-blueprints.git
-
Execute o seguinte comando para navegar até o repositório de esquemas no GitHub:
cd codecatalyst-blueprints
-
Execute o seguinte comando para instalar dependências:
yarn && yarn build
-
Execute o seguinte comando para garantir que a versão mais recente da CLI do esquema esteja instalada:
yarn upgrade @amazon-codecatalyst/blueprint-util.cli
-
Faça login na conta da AWS com o bucket do S3 no qual você deseja fazer upload da imagem. Para ter mais informações, consulte Configure the AWS CLI e Sign in through the AWS Command Line Interface.
-
Execute o seguinte comando na raiz do repositório do CodeCatalyst para navegar até o diretório com a CLI do esquema:
cd packages/utils/blueprint-cli
-
Execute o seguinte comando para fazer upload da imagem em um bucket S3:
yarn blueprint upload-image-public
<./path/to/your/image>
<optional:optional-bucket-name>
Um URL para a imagem é gerado. O URL não estará disponível imediatamente, pois requer algum tempo para que a distribuição do CloudFront seja implantada. Confira o status da distribuição para saber o status de implantação mais recente. Para ter mais informações, consulte Trabalhar com distribuições.