Salta ai contenuti

Rimuovere e pulire

La pulizia viene eseguita nell’ordine inverso rispetto alla creazione: prima il dispositivo smette di eseguire il componente, poi viene rimosso lo stack, poi le risorse che lo stack ha conservato, poi il dispositivo e la sua identità, e infine il profilo dell’istanza.

L’eliminazione di una risorsa di deployment rimuove lo stato di gestione del deployment. Non disinstalla nulla da un dispositivo. Il dispositivo rimuove un componente solo quando riceve una revisione di deployment che non lo elenca più. Modifica lo stack in modo che il deployment non elenchi componenti mentre la versione pubblicata rimane gestita:

import {
GreengrassArtifactBucket,
GreengrassDeployment,
Pulse,
} from '@greengrass-tutorial/common-constructs';
import { CfnParameter, Stack, type StackProps } from 'aws-cdk-lib';
import { Role } from 'aws-cdk-lib/aws-iam';
import type { Construct } from 'constructs';
export class ApplicationStack extends Stack {
constructor(scope: Construct, id: string, props?: StackProps) {
super(scope, id, props);
// Both values are written to .greengrass-tutorial.env by the setup script
// and passed with --parameters on every deploy.
const tokenExchangeRoleArn = new CfnParameter(
this,
'TokenExchangeRoleArn',
{
type: 'String',
description: 'ARN of the core device token exchange role',
},
);
const thingGroupArn = new CfnParameter(this, 'ThingGroupArn', {
type: 'String',
description: 'ARN of the thing group that holds the core device',
});
// The retained artifact repository, and the read grant the core device
// needs to fetch this component's artifacts from it.
const artifacts = new GreengrassArtifactBucket(this, 'Artifacts');
const tokenExchangeRole = Role.fromRoleArn(
this,
'TokenExchangeRole',
tokenExchangeRoleArn.valueAsString,
);
artifacts.grantReadTo(tokenExchangeRole, 'com.example.Pulse/*');
// The published version stays managed. This deployment revision lists no
// components, so the core device uninstalls com.example.Pulse.
new Pulse(this, 'Pulse', { bucket: artifacts });
new GreengrassDeployment(this, 'Fleet', {
targetArn: thingGroupArn.valueAsString,
});
}
}

Distribuisci la revisione:

Terminal window
AWS_PROFILE="$TUTORIAL_AWS_PROFILE" AWS_REGION="$TUTORIAL_AWS_REGION" pnpm nx run @greengrass-tutorial/infra:deploy -- "greengrass-tutorial-infra-sandbox/**" --parameters TokenExchangeRoleArn="$TUTORIAL_TOKEN_EXCHANGE_ROLE_ARN" --parameters ThingGroupArn="$TUTORIAL_THING_GROUP_ARN"

Attendi fino a quando il componente scompare dal dispositivo e il dispositivo rimane integro:

Finestra del terminale
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" greengrassv2 list-installed-components \
--core-device-thing-name "$TUTORIAL_THING_NAME" \
--query 'installedComponents[].componentName' --output text
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" greengrassv2 get-core-device \
--core-device-thing-name "$TUTORIAL_THING_NAME" --query status --output text

Il primo comando non deve più elencare com.example.Pulse. Il secondo deve stampare HEALTHY. Il client di test MQTT smette di ricevere heartbeat.

Terminal window
AWS_PROFILE="$TUTORIAL_AWS_PROFILE" AWS_REGION="$TUTORIAL_AWS_REGION" pnpm nx run @greengrass-tutorial/infra:destroy -- "greengrass-tutorial-infra-sandbox/**" --force

Lo stack è stato rimosso, ma tre tipi di risorse vengono conservate di proposito, perché le versioni dei componenti sono immutabili e sopravvivono a qualsiasi singolo deployment:

  • Entrambe le versioni del componente com.example.Pulse, 1.0.0 e 1.0.1.
  • Le tre revisioni di deployment al thing group.
  • Il bucket degli artifact, con un archivio per ogni versione pubblicata.

Rimane anche lo stack di bootstrap CDK CDKToolkit. È condiviso da ogni applicazione CDK nell’account e nella Region, quindi lascialo a meno che tu non l’abbia creato per questo tutorial.

CDK lascia i gruppi di log Lambda per la risoluzione della versione del componente, il framework delle risorse personalizzate e BucketDeployment dopo l’eliminazione dello stack; eliminali separatamente se non hai più bisogno dei loro log.

Task 3: Eliminare le risorse Greengrass conservate

Sezione intitolata “Task 3: Eliminare le risorse Greengrass conservate”

Elenca i deployment al thing group. Annulla quello ancora ACTIVE, quindi elimina ciascuno di essi:

Finestra del terminale
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" greengrassv2 list-deployments \
--target-arn "$TUTORIAL_THING_GROUP_ARN" --history-filter ALL \
--query 'deployments[].[deploymentId,deploymentStatus]' --output text
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" greengrassv2 cancel-deployment \
--deployment-id <active-deployment-id>
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" greengrassv2 delete-deployment \
--deployment-id <deployment-id>

Elimina ogni versione pubblicata del componente:

Finestra del terminale
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" greengrassv2 list-component-versions \
--arn "arn:aws:greengrass:${TUTORIAL_AWS_REGION}:${TUTORIAL_ACCOUNT_ID}:components:com.example.Pulse" \
--query 'componentVersions[].arn' --output text
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" greengrassv2 delete-component \
--arn <component-version-arn>

Trova il bucket degli artifact tramite il tag di proprietà che il costrutto applica, conferma che l’elenco contenga solo il bucket di questo tutorial, quindi elimina le versioni degli oggetti e il bucket:

Finestra del terminale
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" resourcegroupstaggingapi get-resources \
--tag-filters Key=greengrass-artifact-repository,Values=true \
--resource-type-filters s3:bucket \
--query 'ResourceTagMappingList[].ResourceARN' --output text
export TUTORIAL_BUCKET=<bucket-name>
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" s3api list-object-versions \
--bucket "$TUTORIAL_BUCKET" \
--query '{Objects: Versions[].{Key: Key, VersionId: VersionId}}' --output json \
> /tmp/greengrass-tutorial-versions.json
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" s3api delete-objects \
--bucket "$TUTORIAL_BUCKET" --delete file:///tmp/greengrass-tutorial-versions.json
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" s3api delete-bucket \
--bucket "$TUTORIAL_BUCKET"

Il bucket è versionato, quindi delete-objects deve nominare ogni versione. Se list-object-versions riporta anche DeleteMarkers, ripeti l’eliminazione con quelle voci prima di eliminare il bucket.

Task 4: Rimuovere il core device e la sua identità

Sezione intitolata “Task 4: Rimuovere il core device e la sua identità”

L’operazione cleanup dello script legge .greengrass-tutorial.env, verifica che appartenga allo stesso account, Region e prefisso, e quindi termina l’istanza, scollega ed elimina il certificato con ogni policy ad esso collegata, elimina il record del core device, il thing e il thing group, entrambe le policy IoT, il role alias, il token exchange role con i suoi allegati e l’access policy.

Finestra del terminale
./setup-greengrass-tutorial.sh cleanup \
--profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" --prefix "$TUTORIAL_PREFIX"

Ogni passaggio stampa deleted o absent. Un oggetto che è già stato rimosso viene saltato. Qualsiasi altro errore interrompe l’esecuzione e mantiene il file di stato, in modo da poter correggere la causa e rieseguire lo stesso comando.

Il profilo dell’istanza era tuo, quindi lo script lo lascia intatto:

Finestra del terminale
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" iam remove-role-from-instance-profile \
--instance-profile-name "${TUTORIAL_PREFIX}-instance" --role-name "${TUTORIAL_PREFIX}-instance"
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" iam delete-instance-profile \
--instance-profile-name "${TUTORIAL_PREFIX}-instance"
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" iam detach-role-policy \
--role-name "${TUTORIAL_PREFIX}-instance" \
--policy-arn arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore
aws --profile "$TUTORIAL_AWS_PROFILE" --region "$TUTORIAL_AWS_REGION" iam delete-role \
--role-name "${TUTORIAL_PREFIX}-instance"
rm -f .greengrass-tutorial.env
  • Un componente generato pubblica tramite IPC locale per impostazione predefinita. Cloud MQTT necessita di publish_to_iot_core, un’autorizzazione aws.greengrass.ipc.mqttproxy nella ricetta e iot:Publish nella policy IoT del dispositivo.
  • Il generatore fornisce blocchi di costruzione. Il tuo stack CDK possiede il repository degli artifact, la concessione di lettura e il deployment, e addComponent trasporta la versione risolta e l’edge di ordinamento.
  • NEXT_PATCH alloca una versione dal contenuto. Una modifica del sorgente pubblica la prossima versione patch attraverso il normale deploy.
  • La rimozione di un componente è una revisione di deployment. L’eliminazione dell’infrastruttura è un passaggio separato e successivo che lascia versioni conservate, deployment e il bucket da eliminare.

Per il versionamento e la conservazione degli artifact, leggi le sezioni versionamento e archiviazione degli artifact della guida ai componenti. La stessa guida elenca i limiti del servizio da considerare per deployment più grandi.