AWS Blockchain Templates se suspendió el 30 de abril de 2019. No habrá más actualizaciones de este servicio ni de esta documentación complementaria. Para disfrutar de la mejor experiencia de Managed Blockchain AWS, le recomendamos que utilice Amazon Managed Blockchain (AMB).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Hyperledger Fabric es un marco de trabajo de cadena de bloques que ejecuta contratos inteligentes denominados código de cadena escritos en Go. Es posible crear una red privada con Hyperledger Fabric para limitar los homólogos que se pueden conectar a la red y participar en ella. Para obtener más información sobre Hyperledger Fabric, consulte la documentación de Hyperledger Fabric.
La plantilla de cadena de bloques de AWS para Hyperledger Fabric solo admite una plataforma de contenedores local de Docker, lo que significa que los contenedores de Hyperledger Fabric se implementan en una sola instancia. EC2
Enlaces para el lanzamiento
Consulte Introducción a las plantillas de Blockchain de AWS
AWS Blockchain Template para componentes de Hyperledger Fabric
La plantilla de cadena de bloques de AWS para Hyperledger Fabric crea una EC2 instancia con Docker y lanza una red de Hyperledger Fabric mediante contenedores en esa instancia. La red incluye un servicio de orden y tres organizaciones, cada una con un servicio de homólogos. La plantilla también lanza un contenedor de Hyperledger Explorer, que le permite examinar los datos de cadena de bloques. Se lanza un contenedor de servidor de PostgreSQL para admitir Hyperledger Explorer.
El siguiente diagrama muestra una red de Hyperledger Fabric creada con la plantilla:
Requisitos previos
Antes de lanzar una red de Hyperledger Fabric con la plantilla, asegúrese de que se cumplen los requisitos siguientes:
La entidad principal (usuario o grupo) de IAM que utilice debe tener permiso para trabajar con todos los servicios relacionados.
Debe tener acceso a un key pair que pueda usar para acceder a EC2 las instancias (por ejemplo, mediante SSH). La clave debe existir en la misma región que la instancia.
Debe tener un perfil de EC2 instancia con una política de permisos adjunta que permita acceder a Amazon S3 y a Amazon Elastic Container Registry (Amazon ECR) para extraer contenedores. Si desea ver un ejemplo de política de permisos, consulte Ejemplo de permisos de IAM para el perfil de la instancia EC2 .
Debe tener una red de Amazon VPC con una subred pública o una subred privada con una puerta de enlace NAT y una dirección IP elástica para poder acceder a Amazon S3 AWS CloudFormation y Amazon ECR.
Debe tener un grupo de EC2 seguridad con reglas de entrada que permitan el tráfico SSH (puerto 22) desde las direcciones IP que necesitan conectarse a la instancia mediante SSH, y lo mismo para los clientes que necesitan conectarse a Hyperledger Explorer (puerto 8080).
Ejemplo de permisos de IAM para el perfil de la instancia EC2
Al utilizar la plantilla de cadena de bloques de AWS para Hyperledger Fabric, debe especificar un ARN de perfil de EC2 instancia como uno de los parámetros. Utilice la siguiente declaración de política como punto de partida para la política de permisos adjunta a ese EC2 rol y perfil de instancia.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ecr:GetAuthorizationToken",
"ecr:BatchCheckLayerAvailability",
"ecr:GetDownloadUrlForLayer",
"ecr:GetRepositoryPolicy",
"ecr:DescribeRepositories",
"ecr:ListImages",
"ecr:DescribeImages",
"ecr:BatchGetImage",
"s3:Get*",
"s3:List*"
],
"Resource": "*"
}
]
}
Conexión a los recursos de Hyperledger Fabric
Cuando la pila raíz que cree con la plantilla muestre CREATE_COMPLETE, podrá conectarse a los recursos de Hyperledger Fabric de la instancia. EC2 Si especificó una subred pública, puede conectarse a la instancia como lo haría con cualquier otra EC2 instancia. EC2 Para obtener más información, consulte Conexión a su instancia de Linux mediante SSH en la Guía del EC2 usuario de Amazon.
Si ha especificado una subred privada, puede configurar y utilizar un host bastión para que actúe como proxy en las conexiones a los recursos de Hyperledger Fabric. Para obtener más información, consulte Conexiones proxy mediante un host bastión más abajo.
nota
Puede observar que la plantilla asigna una dirección IP pública a la EC2 instancia que aloja los servicios de Hyperledger Fabric; sin embargo, esta dirección IP no es de acceso público porque las políticas de enrutamiento de la subred privada que especifique no permiten el tráfico entre esta dirección IP y las fuentes públicas.
Conexiones proxy mediante un host bastión
En algunas configuraciones, es posible que los servicios de Hyperledger Fabric no estén disponibles públicamente. En esos casos, puede conectarse a los recursos de Hyperledger Fabric a través de un host bastión. Para obtener más información sobre los hosts bastión, consulte Arquitectura de host bastión de Linux en la Guía de inicio rápido del host bastión de Linux.
El host bastión es una instancia. EC2 Asegúrese de que se cumplan los siguientes requisitos:
La EC2 instancia del host bastión se encuentra dentro de una subred pública con la asignación automática de IP pública habilitada y que tiene una puerta de enlace a Internet.
El host bastión tiene el par de claves que permite conexiones SSH.
El host bastión está asociado a un grupo de seguridad que permite el tráfico SSH entrante desde los clientes que se conecten.
El grupo de seguridad asignado a los hosts de Hyperledger Fabric (por ejemplo, Application Load Balancer si ECS es la plataforma de contenedores o la instancia de EC2 host si docker-local es la plataforma de contenedores) permite el tráfico entrante en todos los puertos desde fuentes de la VPC.
Si tiene un host bastión configurado, asegúrese de que los clientes que se conecten utilicen el host bastión como proxy. En el siguiente ejemplo, se muestra cómo establecer una conexión de proxy mediante Mac OS. BastionIPSustitúyala por la dirección IP de la EC2 instancia del host del bastión y MySshKey.pem por el archivo de pares de claves que copiaste en el host del bastión.
En la línea de comando, escriba lo siguiente:
ssh -imySshKey.pemec2-user@BastionIP-D 9001
Así se configura el reenvío de puertos del puerto 9001 de la máquina local al host bastión.
A continuación, configure su navegador o sistema para que utilice el proxy SOCKS para localhost:9001. Por ejemplo, si usa Mac OS, seleccione System preferences (Preferencias del Sistema), Network (Red), Advanced (Avanzado), seleccione SOCKS proxy y escriba localhost:9001.
Si utilizas la opción FoxyProxy Estándar con Chrome, selecciona Más herramientas y extensiones. En FoxyProxy Estándar, selecciona Detalles, Opciones de extensión y Añadir nuevo proxy. Seleccione Manual Proxy Configuration (Configuración manual del proxy). En Host or IP Address (Host o dirección IP) escriba localhost y en Port (Puerto) escriba 9001. Seleccione SOCKS Proxy?, Save (Guardar).
Ahora debería poder conectarse a las direcciones de host de Hyperledger Fabric enumeradas en la salida de la plantilla.
