Administración de nombres de dominio personalizados para un servicio de App Runner

Al crear unAWS App Runner, App Runner le asigna un nombre de dominio. Este es un subdominio en elawsapprunner.comque es propiedad de App Runner. Se puede utilizar para acceder a la aplicación web que se está ejecutando en su servicio.

Si dispone de un nombre de dominio, puede asociarlo a su servicio App Runner. Después de que App Runner valida tu nuevo dominio, se puede utilizar para acceder a tu aplicación además del dominio App Runner. Puede asociar hasta cinco dominios personalizados.

nota

Si lo desea, puede incluir elwwwsubdominio de su dominio. Sin embargo, en la actualidad sólo se admite en la API. La consola de App Runner no lo admite.

Cuando asocia un dominio personalizado con su servicio, App Runner le proporciona un conjunto de registros de validación de certificados. Añádelos a tu Sistema de nombres de dominio (DNS) para que App Runner pueda validar que eres propietario o controla el dominio. Además, agregue los registros CNAME o ALIAS a su DNS para dirigirse al dominio de App Runner. Debe agregar un registro para el dominio personalizado y otro para elwww, si elige esta opción. Luego espere a que el estado del dominio personalizado se convierta enActivaen la consola de App Runner. Esto suele tardar varios minutos (pero puede tardar entre 24 y 48 horas). En este punto, su dominio personalizado se valida y App Runner comienza a enrutar el tráfico de este dominio a su aplicación web.

Puede especificar un dominio para asociar con el servicio App Runner de las siguientes maneras:

• Un dominio raíz— Por ejemplo,example.com. Si lo desea, puede asociarwww.example.comTambién como parte de la misma operación.

• Un subdominio— Por ejemplo,login.example.comoradmin.login.example.com. Opcionalmente, puede asociar elwwwcomo parte de la misma operación.

• Un comodín ()— Por ejemplo,*.example.com. No puede usar elwwwEn este caso. Puede especificar un comodín solo como el subdominio inmediato de un dominio raíz y solo por sí mismo (estas especificaciones no son válidas:login*.example.com,*.login.example.com). Esta especificación comodín asocia todos los subdominios inmediatos y no asocia el dominio raíz en sí (el dominio raíz tendría que estar asociado en una operación separada).

Una asociación de dominio más específica anula una menos específica. Por ejemplo,login.example.comAnulaciones*.example.com. Se utilizan el certificado y CNAME de la asociación más específica.

En el ejemplo siguiente se muestra cómo se pueden utilizar varias asociaciones de dominio personalizadas:

1. Asociativoexample.comcon la página de inicio de su servicio. Habilitación dewwwpara asociar tambiénwww.example.com.

2. Asociativologin.example.comcon la página de inicio de sesión de su servicio.

3. Asociativo*.example.comcon una página personalizada «no encontrada».

Puede desasociar (desvincular) un dominio personalizado del servicio App Runner. Cuando desvincula un dominio, App Runner deja de enrutar el tráfico de este dominio a la aplicación web. Debe eliminar los registros de este dominio de su DNS.

App Runner crea internamente certificados que rastrean la validez del dominio. Están almacenados enAWS Certificate Manager(ACM). App Runner no elimina estos certificados durante siete días después de que un dominio se haya desasociado del servicio o después de que se haya eliminado el servicio.

Administrar dominios personalizados con la consola de App Runner

Para asociar (vincular) un dominio personalizado mediante la consola de App Runner

1. Abra el iconoConsola de App Runner, y en elRegiones, seleccione suRegión de AWS.

2. En el panel de navegación, elijaServiciosy, a continuación, elige tu servicio App Runner.

   La consola muestra el panel de servicio con unInformación general del servicio.

3. En la página del panel de servicio, elija la opciónDominios personalizadosPestaña.

   La consola muestra los dominios personalizados asociados con el servicio, oNo hay dominios personalizados.

   

4. En la páginaDominios personalizados, elijaDominio de enlace.

5. En el navegadorVincular dominio personalizado, escriba un nombre de dominio y, a continuación, elijaVer configuración de DNS.

6. Siga las instrucciones de laConfiguración de DNSpara iniciar el proceso de validación del dominio.

7. Cuando el estado del dominio cambia aActiva, compruebe que el dominio funciona para enrutar el tráfico navegando hasta él.

Para desasociar (desvincular) un dominio personalizado mediante la consola de App Runner

1. En la páginaDominios personalizados, seleccione el mosaico del dominio que desea desasociar y, a continuación, elijaDesvinculación de dominio.

2. En el navegadorDesvinculación de dominio, verifique la acción seleccionandoDesvinculación de dominio.

Administrar dominios personalizados mediante la API de App Runner oAWS CLI

Para asociar un dominio personalizado con su servicio mediante la API de App Runner oAWS CLI, llame alAssociateCustomDomainAcción de la API. Cuando la llamada se realiza correctamente, devuelve unCustomDomainque describe el dominio personalizado que se está asociando con el servicio. El objeto debe mostrar un estado deCREATINGy contiene una lista deCertificateValidationRecordObjetos. Estos son registros que puede agregar a su DNS.

Para desasociar un dominio personalizado del servicio mediante la API de App Runner oAWS CLI, llame alDisasociateCustomDomainAcción de la API. Cuando la llamada se realiza correctamente, devuelve unCustomDomainque describe el dominio personalizado que se está desasociando del servicio. El objeto debe mostrar un estado deDELETING.