Kuidas kasutada HashiCorpi Waypointi koostööks GitLabi CI/CD-ga

HashiCorp esitles uut projekti Waypoint järgnevaga HashiCorp Digital. See kasutab HCL-põhist faili rakenduste koostamiseks, tarnimiseks ja väljalaskmiseks erinevatele pilveplatvormidele, sealhulgas Kubernetes, AWS ja Google Cloud Run. Waypointit võib võrrelda Terraformi ja Vagrandi kombinatsiooniga, mis kirjeldab teie rakenduste koostamise, tarnimise ja väljalaskeprotsessi.

Oma avatuse säilitades on HashiCorp välja andnud avatud lähtekoodiga Waypointi, millele on lisatud mitmeid näidiseid. Orkestratsiooni tase jääb teie valida, kuna Waypoint on väljastatud käivitatava failina, mida saate käivitada otse oma sülearvutis või valitud CI/CD orkestratsiooni tööriistast. Rakenduste juurutamise eesmärk on samuti teie valida, kuna Waypoint toetab Kubernetesit, Dockerit, Google Cloud Runi, AWS ECS-i ja teisi.

Pärast fantastiliste dokumentatsiooni ja uhkete näidiste rakendustest, mille on pakkunud HashiCorp, otsustasime lähemalt vaadata Waypointi orkestratsiooni GitLabi CI/CD abil. Selleks võtame kasutusele lihtsa Node.js rakenduse, mida käitatakse AWS ECS-is, ja toome selle näidispoest.

Pärast reposti kloonimist vaatame rakenduse struktuuri, mis kuvab ühte lehte:

Kuidas te ilmselt märkisite, selles projektis puudub Dockerfile. Need ei ole näites lisatud, kuna nad ei ole meile üldiselt vajalikud, sest Waypoint hoolitseb nende eest meie eest. Vaatame lähemalt faili waypoint.hcl, et mõista, mida see teeb:

project = "example-nodejs"

app "example-nodejs" {
  labels = {
    "service" = "example-nodejs",
    "env" = "dev"
  }

  build {
    use "pack" {}
    registry {
    use "aws-ecr" {
        region = "us-east-1"
        repository = "waypoint-gitlab"
        tag = "latest"
    }
    }
  }

  deploy {
    use "aws-ecs" {
    region = "us-east-1"
    memory = "512"
    }
  }
}

Kogumise etapis kasutab Waypoint Cloud Native Buildpacks (CNB), et määrata projekti programmeerimiskeel ja luua Docker image ilma Dockerfile'i kasutamata. Põhimõtteliselt on see sama tehnoloogia, mida GitLab kasutab Auto DevOps Auto Build'i sammul. Tore on näha, et CNB CNCF poolt on tööstuses üha enam levinud.

Kuni pilt on kogutud, laadib Waypoint selle automaatselt meie AWS ECR registrisse, et see oleks valmis tarnimiseks. Kogumise lõppedes kasutatakse tarnimise sammus AWS ECS täiendust meie rakenduse juurutamiseks meie AWS kontole.

Minu sülearvutist — kõik on lihtne. Panen paika Waypointi, mis on juba minu AWS kontoga autentitud, ja see „lihtsalt töötab“. Aga mis juhtub, kui ma tahan minna kaugemale oma sülearvutist? Või äkki tahan automatiseerida seda juurutamist osana oma CI/CD kogumisst, kus käivitatakse mu praegused integratsiooni testid, turvatestid ja muud? Just siin tulebki mängu GitLab CI/CD!

N.B. Kui plaanite alles CI/CD juurutamist või soovite alustada parimate praktikate rakendamist torujuhtmete loomisel, vaadake Slërma uut kursust. „CI/CD GitLab CI näitel“. See on nüüd saadaval ettetellimise hinnaga.

Waypoint GitLab CI/CD-s

Kogu selle orkestreerimiseks GitLab CI/CD-s vaatame, mida me vajame meie failis. .gitlab-ci.yml:

• Esmalt on vajalik põhikuju, mille sees seda käivitada. Waypoint töötab igas Linuxi jaotuses, vajab vaid Dockerit, nii et saame alustada generic Docker pildist.
• Seejärel tuleb Waypoint see pilt installida. Tulevikus saame luua meta build pilti ja konteineriseerida selle protsessi enda jaoks.
• Lõpuks käivitame Waypointi käsud.

Ülaltoodud on kõik, mida meie süsteem vajab rakenduste skriptide käivitamiseks, kuid AWS-is käivitamiseks vajame veel ühte asja: peame enda AWS-i kontole sisse logima. Waypointi dokumentatsiooni põhjal on olemas plaanid autentimise ja autoriseerimise kohta. HashiCorp avaldas sel nädalal ka muljetavaldava projekti Boundary. Kuid praegu saame lihtsalt ise autentimise ja autoriseerimise käsitleda.

AWS-i autentimiseks GitLab CICD-s on mitmeid võimalusi. Esimene valik on sisseehitatud HashiCorp Vault. See sobib, kui teie meeskond juba kasutab Vaulti volituste haldamiseks. Teine viis, mis sobib, kui teie tiim haldab autoriseerimist AWS IAM-i kaudu — veenduge, et tarnetooted käivitatakse. GitLabi jooksja, mis on volitatud käivitama IAM-i kaudu rakendust. Kuid kui soovite lihtsalt Waypointiga tutvuda ja seda kiiremini teha, on viimane variant — lisada oma AWS API ja Secret võtmed GitLab CI/CD keskkonnaparameetritesse AWS_ACCESS_KEY_ID ja AWS_SECRET_ACCESS_KEY.

Koondame kõik kokku

Nüüd, kui oleme autentimisega toime tulnud, saame alustada! Meie lõplik .gitlab-ci.yml näeb välja nii:

waypoint:
  image: docker:latest
  stage: build
  services:
    - docker:dind
  # Määrake keskkonnamuutujad, nt `WAYPOINT_VERSION: '0.1.1'`
  variables:
    WAYPOINT_VERSION: ''
    WAYPOINT_SERVER_ADDR: ''
    WAYPOINT_SERVER_TOKEN: ''
    WAYPOINT_SERVER_TLS: '1'
    WAYPOINT_SERVER_TLS_SKIP_VERIFY: '1'
  script:
    - wget -q -O /tmp/waypoint.zip https://releases.hashicorp.com/waypoint/${WAYPOINT_VERSION}/waypoint_${WAYPOINT_VERSION}_linux_amd64.zip
    - unzip -d /usr/local/bin /tmp/waypoint.zip
    - rm -rf /tmp/waypoint*
    - waypoint init
    - waypoint build
    - waypoint deploy
    - waypoint release

Näete, et alustame pildist docker:latest ja määrame mõned keskkonnamuutujad, mis on Waypointi jaoks vajalikud. Jaotises script me laadime alla Waypointi viimase versiooni ja paigaldame selle /usr/local/bin. Kuna meie runner on juba AWS-is autoriseeritud, käivitame lihtsalt waypoint init, build, deploy ja release.

Kogumise ülesande väljund näitab meile lõpp-punkti, kuhu rakenduse välja panime:

Waypoint on üks paljusid HashiCorpi lahendusi, mis töötavad hästi GitLabiga. Näiteks rakenduse tarnimise kõrval saame orkestreerida aluse infrastruktuuri Terraformi abil GitLabis. SDLC turva standardiseerimiseks saame samuti integreerida GitLabi Vaultiga salajasusteemide ja tokenite haldamiseks CI/CD torudes, pakkudes terviklikku lahendust arendajatele ja administraatoritele, kes sõltuvad saladuste haldamisest arendamisel, testimisel ja ka tööstuslikul kasutamisel.

HashiCorpi ja GitLabi koostöös loodud lahendused aitavad ettevõtetel leida parima rakenduste arendamise viisi, tagades sujuva tarnete haldamise ja infrastruktuuri. Waypoint tegi veel ühe sammu õiges suunas ning ootame innukalt projekti edasist arengut. Lisainformatsiooni saamiseks Waypointi kohta siit, tasub uurida dokumentatsiooni ja arenduskava projekti. Omandasime meie teadmised GitLab CICD dokumentatsioonis. Kui soovite kõike ise praktikas proovida, siis saate täispika töötava näite selles hoidlas.

CI/CD põhimõtete mõistmiseks, GitLab CI töödetailide omandamiseks ja parimate praktikate rakendamiseks on võimalik osaleda videokursusel „CI/CD GitLab CI näitel“. Liituge!

Allikas: habr.com