Skip to content

Commit

Permalink
refactor(pubsub): Encapsulate logic for creating events (#523)
Browse files Browse the repository at this point in the history
* feat(pubsub): Send pubsub events through eventPropagator

Currently all pubsub events are sent directly to the trigger
event listener, rather than to the general eventPropagator (which
notifies all event listeners). This means that pubsub events can
never do anything other than start pipelines. (Other incoming
events, such as webhooks or build notifications are sent to the
general eventPropagator.)

In order to allow pubsub messages to do other things than start
pipelines, send the resulting event to the eventPropagator so
that other listeners can act on these events.

* refactor(pubsub): Encapsulate logic for creating events

The logic for extracting artifacts from pubsub events and for creating
events from the message is embedded in the logic for handling these
messages. In order to allow more general events to be created from
pubsub messages, create an interface EventCreator that handles
creating an event from a pubsub MessageDescription.

The initial implementation of EventCreator will extract artifacts and
create exactly the same event as prior to this change, allowing us
to remove the code from the pubsub subscribers and handler.

When setting up a subscription it is now possible to pass in a custom
EventCreator so that messages read from that subscription create
arbitrary event types.
  • Loading branch information
ezimanyi authored Apr 18, 2019
1 parent d3f21ca commit 5d16e86
Show file tree
Hide file tree
Showing 9 changed files with 203 additions and 135 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -23,25 +23,21 @@
import com.amazonaws.services.sqs.model.ReceiveMessageRequest;
import com.amazonaws.services.sqs.model.ReceiveMessageResult;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.hubspot.jinjava.interpret.FatalTemplateErrorsException;
import com.netflix.spectator.api.Id;
import com.netflix.spectator.api.Registry;
import com.netflix.spinnaker.echo.artifacts.MessageArtifactTranslator;
import com.netflix.spinnaker.echo.config.AmazonPubsubProperties;
import com.netflix.spinnaker.echo.model.pubsub.MessageDescription;
import com.netflix.spinnaker.echo.model.pubsub.PubsubSystem;
import com.netflix.spinnaker.echo.pubsub.PubsubMessageHandler;
import com.netflix.spinnaker.echo.pubsub.model.PubsubSubscriber;
import com.netflix.spinnaker.echo.pubsub.utils.NodeIdentity;
import com.netflix.spinnaker.kork.artifacts.model.Artifact;
import com.netflix.spinnaker.kork.aws.ARN;
import com.netflix.spinnaker.kork.aws.pubsub.PubSubUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.IOException;
import java.util.Collections;
import java.util.List;
import java.util.Map;
import java.util.function.Supplier;
import java.util.stream.Collectors;
Expand All @@ -65,7 +61,6 @@ public class SQSSubscriber implements Runnable, PubsubSubscriber {
private final AmazonPubsubProperties.AmazonPubsubSubscription subscription;

private final PubsubMessageHandler pubsubMessageHandler;
private final MessageArtifactTranslator messageArtifactTranslator;

private final NodeIdentity identity = new NodeIdentity();

Expand All @@ -84,8 +79,7 @@ public SQSSubscriber(ObjectMapper objectMapper,
AmazonSNS amazonSNS,
AmazonSQS amazonSQS,
Supplier<Boolean> isEnabled,
Registry registry,
MessageArtifactTranslator.Factory messageArtifactTranslatorFactory) {
Registry registry) {
this.objectMapper = objectMapper;
this.subscription = subscription;
this.pubsubMessageHandler = pubsubMessageHandler;
Expand All @@ -94,7 +88,6 @@ public SQSSubscriber(ObjectMapper objectMapper,
this.isEnabled = isEnabled;
this.registry = registry;

this.messageArtifactTranslator = messageArtifactTranslatorFactory.createJinja(subscription.readTemplatePath());
this.queueARN = new ARN(subscription.getQueueARN());
this.topicARN = new ARN(subscription.getTopicARN());
}
Expand Down Expand Up @@ -191,14 +184,6 @@ private void handleMessage(Message message) {

AmazonMessageAcknowledger acknowledger = new AmazonMessageAcknowledger(amazonSQS, queueId, message, registry, getName());

if (subscription.getMessageFormat() != AmazonPubsubProperties.MessageFormat.NONE) {
try {
description.setArtifacts(parseArtifacts(description.getMessagePayload(), messageId));
} catch (FatalTemplateErrorsException e) {
log.error("Template failed to process artifacts for message {}", message, e);
}
}

if (subscription.getAlternateIdInMessageAttributes() != null
&& !subscription.getAlternateIdInMessageAttributes().isEmpty()
&& stringifiedMessageAttributes.containsKey(subscription.getAlternateIdInMessageAttributes())){
Expand All @@ -214,16 +199,6 @@ private void handleMessage(Message message) {
}
}

private List<Artifact> parseArtifacts(String messagePayload, String messageId){
List<Artifact> artifacts = messageArtifactTranslator.parseArtifacts(messagePayload);
// Artifact must have at least a reference defined.
if (artifacts == null || artifacts.size() == 0
|| artifacts.get(0).getReference() == null || artifacts.get(0).getReference().equals("")) {
return Collections.emptyList();
}
return artifacts;
}

private String unmarshalMessageBody(String messageBody) {
String messagePayload = messageBody;
try {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,10 @@
import com.netflix.spinnaker.echo.artifacts.MessageArtifactTranslator;
import com.netflix.spinnaker.echo.config.AmazonPubsubProperties;
import com.netflix.spinnaker.echo.discovery.DiscoveryActivated;
import com.netflix.spinnaker.echo.pubsub.PubsubEventCreator;
import com.netflix.spinnaker.echo.pubsub.PubsubMessageHandler;
import com.netflix.spinnaker.echo.pubsub.PubsubSubscribers;
import com.netflix.spinnaker.echo.pubsub.model.EventCreator;
import com.netflix.spinnaker.echo.pubsub.model.PubsubSubscriber;
import com.netflix.spinnaker.kork.aws.ARN;
import org.slf4j.Logger;
Expand All @@ -38,6 +40,7 @@
import javax.annotation.PostConstruct;
import java.util.ArrayList;
import java.util.List;
import java.util.Optional;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.RejectedExecutionException;
Expand All @@ -54,7 +57,7 @@ public class SQSSubscriberProvider implements DiscoveryActivated {
private final AWSCredentialsProvider awsCredentialsProvider;
private final AmazonPubsubProperties properties;
private final PubsubSubscribers pubsubSubscribers;
private final PubsubMessageHandler pubsubMessageHandler;
private final PubsubMessageHandler.Factory pubsubMessageHandlerFactory;
private final Registry registry;
private final MessageArtifactTranslator.Factory messageArtifactTranslatorFactory;

Expand All @@ -63,14 +66,14 @@ public class SQSSubscriberProvider implements DiscoveryActivated {
AWSCredentialsProvider awsCredentialsProvider,
AmazonPubsubProperties properties,
PubsubSubscribers pubsubSubscribers,
PubsubMessageHandler pubsubMessageHandler,
PubsubMessageHandler.Factory pubsubMessageHandlerFactory,
Registry registry,
MessageArtifactTranslator.Factory messageArtifactTranslatorFactory) {
this.objectMapper = objectMapper;
this.awsCredentialsProvider = awsCredentialsProvider;
this.properties = properties;
this.pubsubSubscribers = pubsubSubscribers;
this.pubsubMessageHandler = pubsubMessageHandler;
this.pubsubMessageHandlerFactory = pubsubMessageHandlerFactory;
this.registry = registry;
this.messageArtifactTranslatorFactory = messageArtifactTranslatorFactory;
}
Expand All @@ -95,10 +98,17 @@ public void start() {

ARN queueArn = new ARN(subscription.getQueueARN());

Optional<MessageArtifactTranslator> messageArtifactTranslator = Optional.empty();
if (subscription.getMessageFormat() != AmazonPubsubProperties.MessageFormat.NONE) {
messageArtifactTranslator = Optional.ofNullable(subscription.readTemplatePath())
.map(messageArtifactTranslatorFactory::createJinja);
}
EventCreator eventCreator = new PubsubEventCreator(messageArtifactTranslator);

SQSSubscriber worker = new SQSSubscriber(
objectMapper,
subscription,
pubsubMessageHandler,
pubsubMessageHandlerFactory.create(eventCreator),
AmazonSNSClientBuilder
.standard()
.withCredentials(awsCredentialsProvider)
Expand All @@ -112,8 +122,7 @@ public void start() {
.withRegion(queueArn.getRegion())
.build(),
enabled::get,
registry,
messageArtifactTranslatorFactory
registry
);

try {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,9 @@ import com.amazonaws.services.sns.AmazonSNS
import com.amazonaws.services.sqs.AmazonSQS
import com.fasterxml.jackson.databind.ObjectMapper
import com.netflix.spectator.api.Registry
import com.netflix.spinnaker.kork.artifacts.parsing.DefaultJinjavaFactory
import com.netflix.spinnaker.kork.artifacts.parsing.JinjaArtifactExtractor
import com.netflix.spinnaker.echo.artifacts.MessageArtifactTranslator
import com.netflix.spinnaker.echo.config.AmazonPubsubProperties
import com.netflix.spinnaker.echo.pubsub.PubsubMessageHandler
import com.netflix.spinnaker.kork.aws.ARN
import org.springframework.context.ApplicationEventPublisher
import spock.lang.Shared
import spock.lang.Specification
import spock.lang.Subject
Expand Down Expand Up @@ -54,11 +50,7 @@ class AmazonSQSSubscriberSpec extends Specification {
amazonSNS,
amazonSQS,
{true},
registry,
new MessageArtifactTranslator.Factory(
Mock(ApplicationEventPublisher),
new JinjaArtifactExtractor.Factory(new DefaultJinjavaFactory())
)
registry
)

def 'should unmarshal an sns notification message'() {
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,90 @@
/*
* Copyright 2019 Google, Inc.
*
* 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.
*/

package com.netflix.spinnaker.echo.pubsub;

import com.fasterxml.jackson.databind.ObjectMapper;
import com.hubspot.jinjava.interpret.FatalTemplateErrorsException;
import com.netflix.spinnaker.echo.artifacts.MessageArtifactTranslator;
import com.netflix.spinnaker.echo.model.Event;
import com.netflix.spinnaker.echo.model.Metadata;
import com.netflix.spinnaker.echo.model.pubsub.MessageDescription;
import com.netflix.spinnaker.echo.pipelinetriggers.eventhandlers.PubsubEventHandler;
import com.netflix.spinnaker.echo.pubsub.model.EventCreator;
import com.netflix.spinnaker.kork.artifacts.model.Artifact;
import lombok.extern.slf4j.Slf4j;
import org.springframework.util.CollectionUtils;
import org.springframework.util.StringUtils;

import java.io.IOException;
import java.util.*;

/**
* An EventCreator that extracts artifacts from an incoming message and creates an event of type pubsub from the
* message and artifacts.
*/
@Slf4j
public class PubsubEventCreator implements EventCreator {
private final ObjectMapper objectMapper = new ObjectMapper();
private final Optional<MessageArtifactTranslator> messageArtifactTranslator;

public PubsubEventCreator(Optional<MessageArtifactTranslator> messageArtifactTranslator) {
this.messageArtifactTranslator = messageArtifactTranslator;
}

public Event createEvent(MessageDescription description) {
log.trace("Processing pubsub event with payload {}", description.getMessagePayload());

try {
description.setArtifacts(parseArtifacts(description.getMessagePayload()));
} catch (FatalTemplateErrorsException e) {
log.error("Template failed to process artifacts for message {}", description, e);
}

Event event = new Event();
Map<String, Object> content = new HashMap<>();
Metadata details = new Metadata();

try {
event.setPayload(objectMapper.readValue(description.getMessagePayload(), Map.class));
} catch (IOException e) {
log.warn("Could not parse message payload as JSON", e);
}

content.put("messageDescription", description);
details.setType(PubsubEventHandler.PUBSUB_TRIGGER_TYPE);

if (description.getMessageAttributes() != null) {
details.setAttributes(description.getMessageAttributes());
}

event.setContent(content);
event.setDetails(details);
return event;
}

private List<Artifact> parseArtifacts(String messagePayload) {
if (!messageArtifactTranslator.isPresent()) {
return Collections.emptyList();
}
List<Artifact> artifacts = messageArtifactTranslator.get().parseArtifacts(messagePayload);
// Artifact must have at least a reference defined.
if (CollectionUtils.isEmpty(artifacts) || StringUtils.isEmpty(artifacts.get(0).getReference())) {
return Collections.emptyList();
}
return artifacts;
}
}
Loading

0 comments on commit 5d16e86

Please sign in to comment.