From c9ac0562f56d928c4ecbdcf5db4bfac34b2d9ff6 Mon Sep 17 00:00:00 2001 From: Jack Lucas Date: Fri, 13 Aug 2021 13:57:37 -0400 Subject: Add unconditional Consul key delete Add a script to consul-loader-container that attempts to delete a Consul key and ignores failures rather than looping indefinitely. This will allow us to safely add a k8s Job to each DCAE microservice's Helm chart to delete the microservice's Consul configuration key when the microservice is undeployed using Helm. Issue-ID: DCAEGEN2-2669 Signed-off-by: Jack Lucas Change-Id: I0e9534c4b488d3a3f7248434712900ed5b593489 --- consul-loader-container/Changelog.md | 7 +++++ consul-loader-container/delete_key.sh | 50 +++++++++++++++++++++++++++++++++++ consul-loader-container/pom.xml | 2 +- 3 files changed, 58 insertions(+), 1 deletion(-) create mode 100755 consul-loader-container/delete_key.sh diff --git a/consul-loader-container/Changelog.md b/consul-loader-container/Changelog.md index 88d4818..e065dea 100644 --- a/consul-loader-container/Changelog.md +++ b/consul-loader-container/Changelog.md @@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/). +## [1.1.1] - 2021-08-23: +To address https://jira.onap.org/browse/DCAEGEN2-2669, added a new script +(delete_key.sh) that attempts to delete a Consul key and ignores failures +rather than looping indefinitely. This will allow us to safely add a k8s Job +to each DCAE microservice's Helm chart to delete the microservice's Consul +configuration key when the microservice is undeployed using Helm. + ## [1.1.0] - 2021-02-05: In support of deploying DCAE service components using Helm, the Consul loader has been enhanced to: diff --git a/consul-loader-container/delete_key.sh b/consul-loader-container/delete_key.sh new file mode 100755 index 0000000..bc7daec --- /dev/null +++ b/consul-loader-container/delete_key.sh @@ -0,0 +1,50 @@ +#!/bin/bash +# ================================================================================ +# Copyright (c) 2021 J. F. Lucas. All rights reserved. +# ================================================================================ +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# ============LICENSE_END========================================================= + +# Delete a single key-value pair from the Consul KV store, with no error checking. +# (To have full error checking, using the --delete-key option on the consul_store.sh +# script.) +# This script is intended for use with a Kubernetes Job that deletes the Consul KV pair +# holding the application configuration data for a DCAE microservice, when the microservice +# is undeployed via Helm. The reason for ignoring errors is that sometimes when a full +# ONAP deployment is being undeployed, Consul becomes unavailable before a microservice +# is deleted. If we do a Consul delete with error checking using the consul.sh script, +# the Kubernetes Job loops indefinitely waiting for Consul to become available. This +# script simply sends a delete key request to Consul and ignores the result. +# +# Note that failing to delete the application configuration from Consul is +# not harmful. If a DCAE microservice is undeployed then deployed again, the +# configuration information for the new instance will overwrite the old configuration. +# +# Environment variables control the Consul address used: +# -- CONSUL_PROTO: The protocol (http or https) used to access consul. DEFAULT: http +# -- CONSUL_HOST: The Consul host address. DEFAULT: consul +# -- CONSUL_PORT: The Consul API port. DEFAULT: 8500 +# +# The command accepts a single argument, the name of the key to be deleted. +# +set -x +CONSUL_ADDR=${CONSUL_PROTO:-http}://${CONSUL_HOST:-consul}:${CONSUL_PORT:-8500} +KV_URL=${CONSUL_ADDR}/v1/kv + +if [ "$#" -lt 1 ] +then + echo "Command requires at least one argument" + exit 0 # deliberately masking the error +fi +curl -v -X DELETE "${KV_URL}/$1" +exit 0 # mask any error diff --git a/consul-loader-container/pom.xml b/consul-loader-container/pom.xml index f347ef9..f7d5e62 100644 --- a/consul-loader-container/pom.xml +++ b/consul-loader-container/pom.xml @@ -28,7 +28,7 @@ limitations under the License. org.onap.dcaegen2.deployments consul-loader-container dcaegen2-deployments-consul-loader-container - 1.1.0 + 1.1.1 http://maven.apache.org UTF-8 -- cgit 1.2.3-korg