Deploy a regional self-managed certificate

---

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

This tutorial describes how to use Certificate Manager to deploy a self-managed certificate to a regional external Application Load Balancer or to a regional internal Application Load Balancer.

To deploy a certificate to a regional external Application Load Balancer or to a regional internal Application Load Balancer, attach the certificate directly to the target proxy. To deploy a certificate to a global external Application Load Balancer, create a certificate map and attach the map to the target proxy. For more information, see Deploy a self-managed certificate.

Objectives

This tutorial shows you how to:

• Upload a self-managed certificate to Certificate Manager.
• Deploy the certificate to a regional external Application Load Balancer or to a regional internal Application Load Balancer by using a target HTTPS proxy.

For more information about the certificate deployment process, see Deployment overview.

Before you begin

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Make sure that you have the following roles to complete the tasks in this tutorial:

   • Certificate Manager Owner: Required to create and manage Certificate Manager resources.
   • Compute Load Balancer Admin or Compute Network Admin: Required to create and manage HTTPS target proxy.

   For more information, see the following:

   • Roles and permissions for Certificate Manager
   • Compute Engine IAM roles and permissions for Compute Engine
   Note: If you aren't assigned the permissions or roles, contact the IAM Administrator who has the Project IAM Admin role (roles/resourcemanager.projectIamAdmin) to grant you the missing roles.

Create the load balancer

Create the load balancer where you want to deploy the certificate.

• To create a regional external Application Load Balancer, see Set up a regional external Application Load Balancer with VM instance group backends.
• To create a regional internal Application Load Balancer, see Set up a regional internal Application Load Balancer with VM instance group backends.

The rest of this tutorial assumes that you have already configured the load balancer's backends, health check, backend service, and URL map. Note the name of the URL map because you need it later in this tutorial.

Request and validate a certificate

To request and validate a self-managed certificate, do the following:

1. Use a trusted third-party certificate authority (CA) to issue the certificate along with its associated key.

2. Verify that the certificate is properly chained and root-trusted.

3. Prepare the following PEM-encoded files:

   • The certificate file (CRT)
   • The corresponding private key file (KEY)

For information about how to request and validate a certificate, see Create a private key and certificate.

Upload a self-managed certificate to Certificate Manager

To upload the certificate to Certificate Manager, run the following command:

gcloud certificate-manager certificates create CERTIFICATE_NAME \
    --certificate-file="CERTIFICATE_FILE" \
    --private-key-file="PRIVATE_KEY_FILE" \
    --location="REGION"

Replace the following:

• CERTIFICATE_NAME: a unique name of the certificate
• CERTIFICATE_FILE: the path and filename of the CRT certificate file
• PRIVATE_KEY_FILE: the path and filename of the KEY private key file
• REGION: the target Google Cloud region

Deploy the self-managed certificate to a load balancer

To deploy the self-managed certificate, create an HTTPS target proxy and attach the certificate to it.

Create the HTTPS target proxy

To create the HTTPS target proxy and attach the certificate, run the following command:

gcloud compute target-https-proxies create PROXY_NAME \
    --url-map=URL_MAP \
    --region=REGION \
    --certificate-manager-certificates=CERTIFICATE_NAME

Replace the following:

• PROXY_NAME: a unique name of the proxy.
• URL_MAP: the name of the URL map. You created the URL map when you created the load balancer.
• REGION: the region where you are creating the HTTPS target proxy.
• CERTIFICATE_NAME: the name of the certificate.

To verify whether the target proxy is created, run the following command:

gcloud compute list target-https-proxies

Create a forwarding rule

Set up a forwarding rule and finish setting up the load balancer.

• If you're using a regional external Application Load Balancer, see Set up a regional external Application Load Balancer with VM instance group backends.
• If you're using a regional internal Application Load Balancer, see Set up an regional internal Application Load Balancer with VM instance group backends.

Clean up

To revert the changes that you have made in this tutorial, delete the uploaded certificate:

gcloud certificate-manager certificates delete CERTIFICATE_NAME

Replace CERTIFICATE_NAME with the name of the target certificate.

What's next

• Manage certificates
• Migrate a certificate to Certificate Manager