12-факторные сервисы поддержки приложений в стиле Spring и Cloud Foundry

Автореконфигурация состоит из трех частей. Во-первых, он добавляет cloudпрофиль в список активных профилей Spring. Во- вторых он предоставляет все свойства предоставлены Cloud Foundry , как PropertySourceв ApplicationContext. Наконец, он переписывает определения бинов различных типов для автоматического соединения со службами, привязанными к приложению. Переписаны следующие типы:

Тип бобов	Тип Обслуживания
javax.sql.DataSource	Службы реляционных данных (например, ClearDB, ElephantSQL)
org.springframework.amqp.rabbit.connection.ConnectionFactory	Сервис RabbitMQ (например, CloudAMQP)
org.springframework.data.mongodb.MongoDbFactory	Монго Сервис (например, МонгоЛаб)
org.springframework.data.redis.connection.RedisConnectionFactory	Служба Redis (например, Redis Cloud)
org.springframework.orm.hibernate3.AbstractSessionFactoryBean	Службы реляционных данных (например, ClearDB, ElephantSQL)
org.springframework.orm.hibernate4.LocalSessionFactoryBean	Службы реляционных данных (например, ClearDB, ElephantSQL)
org.springframework.orm.jpa.AbstractEntityManagerFactoryBean	Службы реляционных данных (например, ClearDB, ElephantSQL)

В результате приложение, работающее на H2 локально, автоматически запускается на PostgreSQL на Cloud Foundry, при условии, что у вас есть служба поддержки, указывающая на экземпляр PostgreSQL, созданный и связанный с приложением, как мы это делали выше. Это очень удобно! Если ваши две цели — localhost и Cloud Foundry, это работает отлично.

Полезные Environmentсвойства для вашего приложения Spring

{
	...
	cloud.services.postgresql-db.connection.jdbcurl: "jdbc:postgresql://babar.elephantsql.com:5432/AUSER?user=AUSER&password=WOULDNTYOULIKETOKNOW",
	...
	cloud.services.postgresql-db.connection.uri: "postgres://AUSER:WOULDNTYOULIKETOKNOW@babar.elephantsql.com:5432/AUSER",
	cloud.services.postgresql-db.connection.scheme: "postgres",
	cloud.services.postgresql.connection.jdbcurl: "jdbc:postgresql://babar.elephantsql.com:5432/AUSER?user=AUSER&password=WOULDNTYOULIKETOKNOW",
	cloud.services.postgresql.connection.port: 5432,
	cloud.services.postgresql.connection.path: "AUSER",
	cloud.application.host: "0.0.0.0",
	cloud.services.postgresql-db.connection.password: "******",
	cloud.services.postgresql-db.connection.username: "AUSER",
	...
	cloud.application.application_name: "simple-backing-services",
	cloud.application.limits: {
		mem: 512,
		disk: 1024,
		fds: 16384
	},
	cloud.services.postgresql-db.id: "postgresql-db",
	cloud.application.application_uris: [
	"simple-backing-services-fattiest-teniafuge.cfapps.io",
	"simple-backing-services-unmummifying-prehnite.cfapps.io"
],
	cloud.application.instance_index: 0,
	...
}

{
	...
	vcap.application.start: "2015-01-27 09:58:13 +0000",
	vcap.application.application_version: "9e6ba76e-039f-4585-9573-8efa9f7e9b7e",
	vcap.application.application_uris[2]: "simple-backing-services-detersive-sterigma.cfapps.io",
	vcap.application.uris: "simple-backing-services-fattiest-teniafuge.cfapps.io,simple-backing-services-grottoed-distillment.cfapps.io,...",
	vcap.application.space_name: "joshlong",
	vcap.application.started_at: "2015-01-27 09:58:13 +0000",
	vcap.services.postgresql-db.tags: "Data Stores,Data Store,postgresql,relational,New Product",
	vcap.services.postgresql-db.credentials.uri: "postgres://AUSER:WOULDNTYOULIKETOKNOW@babar.elephantsql.com:5432/hqsugvxo",
	vcap.services.postgresql-db.tags[1]: "Data Store",
	vcap.services.postgresql-db.tags[4]: "New Product",
	vcap.application.application_name: "simple-backing-services",
	vcap.application.name: "simple-backing-services",
	vcap.application.uris[2]: "simple-backing-services-detersive-sterigma.cfapps.io",
	...
}

Использование Spring Profiles

Spring Boot, по умолчанию, загружается src/main/resources/application.(properties,yml). Также будут загружены файлы свойств профиля, имеющие вид формы src/main/resources/application-PROFILE.yml, где PROFILEуказано имя активного профиля Spring . Ранее мы видели, что наш manifest.ymlспециально активирует cloudпрофиль, устанавливая переменную окружения. Итак, предположим, что вы хотели иметь конфигурацию, которая была активирована только при работе в cloudпрофиле, и другую, которая была активирована, когда не было активировано определенного профиля — это называется defaultпрофилем. Вы можете создать три файла: src/main/resources/application-cloud.(properties,yml)которые будут активированы всякий раз, когда активирован cloudпрофиль, src/main/resources/application-default.(properties,yml)который будет активирован, когда никакой другой профиль специально не активирован, иsrc/main/resources/application.(properties,yml) который будет активирован для всех ситуаций, несмотря ни на что.

Образец src/main/resources/application.properties:

spring.jpa.generate-ddl=true

Образец src/main/resources/application-cloud.properties:

spring.datasource.url=${cloud.services.postgresql-db.connection.jdbcurl}

Образец src/main/resources/application-default.properties:

# empty in this case because I rely on the embedded H2 instance being created
# though you could point it to another, local,
# PostgresSQL instancefor dev workstation configuration

Использование PaaS-соединителей Spring Cloud

Все эти варианты до сих пор используют преимущества Environmentабстракции. Без сомнения, они гораздо проще, чем вручную выбирать структуру JSON в VCAP_SERVICESпеременной, но мы можем добиться большего. Как сказано в документации для проекта Spring Cloud Connectors :

Spring Cloud предоставляет простую абстракцию для приложений на основе JVM, работающих на облачных платформах, для обнаружения связанных служб и информации о развертывании во время выполнения, а также обеспечивает поддержку регистрации обнаруженных служб в виде компонентов Spring. Он основан на модели плагинов, так что идентичное скомпилированное приложение может быть развернуто локально или в нескольких облаках, и поддерживает определения пользовательских сервисов через Java SPI.

Давайте посмотрим на наш пересмотренный пример:

package demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.config.java.AbstractCloudConfig;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.rest.core.annotation.RepositoryRestResource;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import javax.sql.DataSource;

@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

    @Configuration
    @Profile("cloud")
    public static class DataSourceConfig extends AbstractCloudConfig {

        @Bean
        DataSource reservationsPostgreSqlDb() {
            return connectionFactory().dataSource("postgresql-db");
        }
    }

}

@RepositoryRestResource
interface ReservationRepository extends JpaRepository<Reservation, Long> {
}

@Entity
class Reservation {
    @Id
    @GeneratedValue
    private Long id;

    public Long getId() {
        return id;
    }

    private String firstName, lastName;

    Reservation() {
    }

    public Reservation(String firstName, String lastName) {
        this.firstName = firstName;
        this.lastName = lastName;
    }

    public String getFirstName() {
        return firstName;
    }

    public String getLastName() {
        return lastName;
    }
}

Вместо того, чтобы конфигурировать javax.sql.DataSourceиспользование свойств и Spring Boot, мы явно производим объект правильного типа. Существуют другие методы для других вспомогательных служб, таких как MongoDB , Redis , SendGrid и т. Д., И вы можете легко предоставить свой собственный. Мы используем плагин Spring Cloud Connectors для Cloud Foundry, хотя нет никаких причин, по которым вы не могли бы использовать плагин Spring Cloud Connectors для Heroku или альтернативу на основе свойств для локальных приложений. Тогда ваше приложение будет одинаковым в разных средах, и отличается только внешняя конфигурация.

Использование конфигурации Java @Beanсек

	@Bean
	@Profile("cloud")
	DataSource dataSource(
			@Value("${cloud.services.postgresql-db.connection.jdbcurl}") String jdbcUrl) {
		try {
			return new SimpleDriverDataSource(
				org.postgresql.Driver.class.newInstance() , jdbcUrl);
		}
		catch (Exception e) {
			throw new RuntimeException(e) ;
		}
	}

До сих пор мы рассматривали только те сервисы, которые предоставляет Cloud Foundry. Если вы хотите использовать услугу, которая у вас есть вне PaaS, достаточно легко обращаться с ней, как с любой другой службой поддержки, используя предоставляемые пользователем услуги Cloud Foundry . Этот механизм — просто причудливый способ рассказать Cloud Foundry о локаторе и учетных данных для пользовательского сервиса, с которым ваши приложения должны взаимодействовать. После того, как вы это сделаете, приложения и службы Cloud Foundry могут привязать этот сервис к своим приложениям и использовать его, как обычно. Предоставляемые пользователями сервисы являются идеальными или сервисами, такими как фиксированный экземпляр Oracle, которыми вы не собираетесь управлять Cloud Foundry. Cloud Foundry не добавляет новые экземпляры, не удаляет их и не контролирует авторизацию.

Если вы хотите, чтобы Cloud Foundry управлял сервисом, вам необходимо адаптировать его к Cloud Foundry с помощью API брокера сервисов . Это более важно при развертывании Cloud Foundry в вашей собственной среде и требует прав администратора (например, которые вы не будете иметь в размещенном Pivotal Cloud Foundry). API сервисного брокера представляет собой набор хорошо известных обратных вызовов REST, о которых необходимо знать Cloud Foundry. Достаточно легко реализовать свой собственный брокер пользовательских сервисов, и даже есть этот удобный проект на основе Spring Boot и соответствующий пример .

Проверьте примеры тоже!